add_rank_keywords
Start tracking keywords for a client, for one place and language. By default Google on desktop and mobile, top 100; Bing and the local lists ("More places", Google Maps) can be switched on with tracks. A keyword that is already tracked for the same place and language is left as it is; a keyword with a search operator (site:, inurl: …) is refused. Tracking runs weekly on the workspace's own DataForSEO account (or, on a Rank Tracker budget, on CrunchJunkie's account, charged to the budget), so every keyword and every engine adds to what is charged: the preview states the most it can cost per month. Get location from find_rank_location. Requires MCP write actions; without confirm:true it returns a preview.
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": {
"clientId": "<clientId>",
"keywords": "<keywords>",
"location": "<location>",
"languageCode": "<languageCode>"
},
"name": "add_rank_keywords"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | ||
| tracks | No | Default: Google desktop + Google mobile, top 100. | |
| confirm | No | Set true to apply. Omit for a preview. With confirm:true, also pass the preview's previewToken. | |
| clientId | Yes | Client id (from list_clients). | |
| keywords | Yes | The keywords, one per entry. An entry may carry its own tags after " | ": "dentist auckland | Local, Core". They are added to the `tags` of the whole call. | |
| location | Yes | Where the search is made from. | |
| targetUrl | No | The page the client WANTS to rank for these keywords. A page of the client's own site. | |
| languageCode | Yes | Search language, e.g. "en", "de". | |
| previewToken | No | With confirm:true: the previewToken from this tool's preview (valid 15 minutes, once, for exactly the previewed arguments). |