List keywords and ranks
List the tracked keywords of one domain with current rank, change and landing page.
MCP tool accuranker_read → list_keywords
read
Returns the rows of the Keywords tab: keyword ID, keyword, search engine, device, location, current rank, change since the compare date, landing page URL and tags. Rows come in the order the tab shows them; follow next_cursor for the rest. A keyword with no rank yet has rank null.
Parameters
| Name | Type | Description |
|---|---|---|
| domain_id string required | string | Domain ID from list_domains. |
| search string | string | Part of a keyword. |
| tag string | string | Only keywords with this tag. |
| search_engine string | string | Google, Bing, Baidu or YouTube. |
| cursor string | string | next_cursor from the previous page; leave out for the first page. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "accuranker_read",
"arguments": {
"operation": "list_keywords",
"arguments": {
"domain_id": "domain_8c41d2"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"keywords": [
{
"keyword_id": "k_90311",
"keyword": "rank tracking software",
"search_engine": "Google",
"device": "desktop",
"location": "United States",
"rank": 4,
"change": 2,
"landing_page": "https://acme-outdoors.com/pricing",
"tags": [
"pricing-pages"
]
},
{
"keyword_id": "k_90312",
"keyword": "keyword rank checker",
"search_engine": "Google",
"device": "mobile",
"location": "United States",
"rank": 7,
"change": 5,
"landing_page": "https://acme-outdoors.com/pricing/teams",
"tags": []
}
],
"next_cursor": null
},
"isError": false
}