Connect popularity source
connect_popularityConnect Apple Ads, Google Ads Keyword Planner, or an imported CSV/JSON file as a real keyword popularity source; credentials are stored securely for later popularity fetches.
Instructions
Connect a source of REAL keyword popularity: apple_ads (Apple Ads API: clientId, teamId, keyId, private key, optional orgId), google_ads_planner (Google Ads Keyword Planner through the owner's own Google Cloud project at Basic access: customerId, refreshToken, oauthClientId, oauthClientSecret, optional loginCustomerId; the owner can also sign in from Settings › Popularity instead) or imported (a popularity export file at filePath). Prefer file paths for keys. Secrets go to the OS keychain and are never returned. Then call fetch_popularity.
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": {
"source": "<source>"
},
"name": "connect_popularity"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keyId | No | apple_ads: key id. | |
| orgId | No | apple_ads: org id when several are visible. | |
| store | No | Store: "apple" (App Store) or "google" (Google Play). | |
| source | Yes | Popularity source. | |
| teamId | No | apple_ads: team id. | |
| clientId | No | apple_ads: client id. | |
| filePath | No | imported: path to the export file (CSV / JSON). | |
| customerId | No | google_ads_planner: customer id. | |
| refreshToken | No | google_ads_planner: OAuth refresh token. | |
| oauthClientId | No | google_ads_planner: OAuth client id. | |
| privateKeyPem | No | apple_ads: PEM contents (prefer privateKeyPath). | |
| developerToken | No | google_ads_planner: legacy developer token (optional; Google retired them, access comes from the Cloud project). | |
| privateKeyPath | No | apple_ads: path to the private key PEM. | |
| loginCustomerId | No | google_ads_planner: manager account id. | |
| oauthClientSecret | No | google_ads_planner: OAuth client secret. |