Read tracked keyword positions
readRankingsGoogle positions for the keywords the merchant tracks: latest is the newest weekly check and previous the one before (null means not in the top 20), url is the page that ranks and pieceId the Kooga article published there (null for any other page), competitors is where each tracked competitor stands on the same search, and odds says whether page one is within reach for a site this strong (within_reach, stretch, long_shot). These are Google rankings, NOT AI visibility. A move of one or two places is noise, not news.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "readRankings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many keywords, most recently checked first | |
| workspaceId | No | The workspace, as listWorkspaces gives it (its id or slug). Leave it out when this connection reaches one workspace. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keywords | Yes |