Skip to main content
The Google AdSense integration closes the loop between traffic and money. Your AI agent can pull earnings, impressions, clicks, CTR, and RPM directly from AdSense and combine them with GSC/Bing/GA4 analysis — no dashboard hopping required.

​
Core Capabilities

​
Accounts

  • adsense_accounts: List configured publisher accounts, or discover every publisher ID your Google account can access (mode: "discover").

​
Reports

  • adsense_report: Earnings & performance reports with dimension breakdowns, metric selection, custom sort order, and row limits.

​
Payments & Policy

  • adsense_payments_alerts: Outstanding payment balances plus active account alerts (policy issues, payment holds).

​
adsense_report Parameters

accountId semantics: accountId refers to the configured profile ID shown by accounts_manage (e.g. adsense_2) — not a publisher resource name like accounts/pub-123. With a single configured account you can omit it entirely.

​
Setup & Authentication

AdSense uses user-authorized OAuth 2.0 only — the AdSense Management API does not support service accounts.
  1. Run Setup: npx search-console-mcp setup --engine=adsense
  2. Consent: Approve the read-only adsense.readonly scope in the browser window.
  3. Account Selection: If your Google account has multiple publisher accounts, pick one from the list. Setup runs a live validation query before saving.
Existing configurations are untouched. Enabling AdSense requires a separate consent step; GSC, Bing, and GA4 users never need to re-authenticate until they opt in.

​
MCP Resources & Prompts

The integration also registers native MCP resources and guided prompts:
  • seo://adsense/accounts — configured publisher accounts
  • seo://adsense/payments — live balances and alerts for every configured account, keyed by account ID
  • adsense_earnings_review — prompt walking your agent through daily trend, top domains, balance, and alerts
  • adsense_monetization_audit — prompt for finding underperforming ad units and geography/platform RPM gaps

​
Example Prompts

“How much did I earn from AdSense in the last 30 days, and which day was best?”
“Break down my AdSense earnings by domain for this month. Which site drives the most revenue?”
“List any active AdSense policy alerts or pending payments.”
“Which ad units have high impressions but low RPM? Use adsense_monetization_audit.”