deepl

1# DeepL
2 
3## Purpose
4Translate text with DeepL: translate between 30+ languages with optional formality control, list supported languages, check character usage. Use when the user mentions DeepL or wants text translated.
5 
6## Tooling
7All commands go through `bin/deepl.py`:
8 
9```bash
10bin/deepl.py auth                                        # verify the key and show usage
11bin/deepl.py translate --text "Hello" --target-lang FR  # translate text
12bin/deepl.py translate --text "Hello" --target-lang DE --source-lang EN --formality more
13bin/deepl.py languages                                  # list supported target languages
14```
15 
16Free-plan keys end in `:fx` and use `api-free.deepl.com` (the default). Paid keys use `api.deepl.com`: pass `--host api.deepl.com` for those.
17 
18## Auth
19- Provider id: `deepl` (credential is collected as `custom.deepl`)
20- Collection: API key via the secure credential flow (`credentials.request_api_access`); created in the DeepL account under API Keys
21- Allowed hosts: `api-free.deepl.com`, `api.deepl.com`
22- Status check: `bin/deepl.py auth` (must return `"ok": true`)
23 
24## Operating Rules
251. Translation is a read-like operation: no confirmation needed, but usage counts against the user's character quota, so keep batches reasonable.
262. Machine translation can be wrong: flag this when the output will be published or used in legal, medical, or brand contexts.
27…