add_keyword
Start tracking a social-listening keyword to monitor brand, competitor, or topic mentions. Results arrive on the listening pipeline’s cadence; poll list_mentions to retrieve them.
Instructions
Start tracking a social-listening keyword. Per-plan keyword caps apply (Professional 5, Enterprise 15). Mentions are fetched on the listening pipeline's own cadence — there is no fetch-now; poll list_mentions for results.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"keyword": "<keyword>"
},
"name": "add_keyword"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | No | brand (default) vs competitor drives the Share of Voice report; topic is excluded from it. | |
| aliases | No | Alternate spellings (max 3). Each alias costs extra search quota. | |
| keyword | Yes | The keyword to track (≤100 characters). | |
| platforms | No | Sources to search, e.g. ["reddit","bluesky","youtube","hackernews"]. Omit for the default set. | |
| brand_context | No | Short description of the brand, used by the AI relevancy scorer. | |
| exclude_terms | No | Skip mentions containing any of these. | |
| require_terms | No | Only keep mentions containing at least one of these. |