Opportunity score (CTR gap)
score_opportunitiesQueries between minPosition and maxPosition whose CTR is below the expected CTR for their position. expectedCtr comes from the property's own curve (ctrSource "own", when the bucket has volume) or from the benchmark; ctrGap = expected − ctr (fraction); lostClicks = impressions × gap; score 0–100 log-normalized by the largest lostClicks (level high >= 80, medium >= 60). Use for title/meta-description quick wins. / Oportunidades por CTR abaixo do esperado.
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": {
"site": "<site>"
},
"name": "score_opportunities"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | Window length in days (default 28). Ignored when startDate and endDate are both given. / Janela em dias. | |
| site | Yes | Property: displayName ("example.com"), Search Console siteUrl ("sc-domain:example.com", "https://www.example.com/") or numeric id. A unique substring among visible properties also works ("exam"). list_sites shows the options. The value "demo" selects a demonstration site with fictional data: it works without signing in and is read-only. / Propriedade por nome, siteUrl ou id; "demo" é um site de demonstração com dados fictícios, sem login e só leitura. | |
| brand | No | all (default); branded = only queries containing one of the property's branded_terms; non-branded = the rest. Needs branded terms set on the property in the Organiq panel, otherwise invalid_argument with the panel URL. / Marca × sem marca. | |
| limit | No | Rows (default 25). | |
| query | No | Only queries containing this text, or a regex as /…/ (e.g. "/^how to/"; no flag = case-insensitive). | |
| device | No | Device. | |
| country | No | Country as ISO-3166-1 alpha-3, as in Search Console: bra, usa, prt, arg. | |
| endDate | No | End yyyy-mm-dd. Default: last synced date of the property (Search Console lags ~3 days; never "today"). Every response states the period used. / Fim; padrão = última data sincronizada. | |
| startDate | No | Start yyyy-mm-dd. Default: endDate − (days − 1). | |
| searchType | No | Search type (default web). | |
| maxPosition | No | Maximum position (default 30). | |
| minPosition | No | Minimum position (default 3). | |
| pageContains | No | Only pages whose URL contains this text (case-insensitive), e.g. "/blog/". | |
| minImpressions | No | Minimum query impressions (default 20). |