AdSense MCP

Un servidor MCP que extrae datos ad hoc de la AdSense Management API v2. Expone una interfaz de informes sin restricciones: todas las dimensiones, métricas, filtros, períodos de tiempo, órdenes de clasificación, zonas horarias, idiomas, monedas y límites admitidos de AdSense se pueden pasar a accounts.reports.generate.

El servidor utiliza el alcance OAuth de solo lectura https://www.googleapis.com/auth/adsense.readonly. No escribe en una cuenta de AdSense.

Instalación

Una vez publicado, ejecútelo desde un cliente MCP con npx -y @sirmacke/adsense-mcp. Configure ADSENSE_ACCESS_TOKEN o los tres valores ADSENSE_CLIENT_ID, ADSENSE_CLIENT_SECRET y ADSENSE_REFRESH_TOKEN.

Related MCP server: google-ads-mcp

Seguridad

Los tokens de acceso OAuth, los tokens de actualización y los secretos de cliente son credenciales. Manténgalos fuera de este repositorio, de los rastreadores de incidencias, del historial del shell y de la configuración de MCP compartida con otras personas. Si uno se expone, revóquelo en Google Cloud inmediatamente; consulte SECURITY.md.

Configuración

1. En Google Cloud, habilite la AdSense Management API y cree un cliente OAuth de escritorio.

2. Obtenga un token de actualización al que se le haya concedido el alcance https://www.googleapis.com/auth/adsense.readonly. Manténgalo en secreto.

3. Copie .env.example a su configuración de entorno segura y complete ADSENSE_ACCESS_TOKEN o el ID de cliente, secreto y token de actualización de OAuth.

4. Instale y compile:

npm install
npm run build

Autorización OAuth de una sola vez (sin gcloud)

Descargue el JSON del cliente de escritorio de OAuth desde Google Cloud y, a continuación, ejecute:

$env:ADSENSE_OAUTH_CLIENT_FILE = "C:\secure\adsense-client.json"
$env:ADSENSE_TOKEN_FILE = "C:\secure\adsense-oauth.json"
npm run authorize

El comando abre la pantalla de consentimiento de Google en una devolución de llamada de localhost y guarda el ID de cliente, el secreto de cliente y el token de actualización únicamente en el archivo de tokens privado. Copie esos valores en los campos ADSENSE_CLIENT_ID, ADSENSE_CLIENT_SECRET y ADSENSE_REFRESH_TOKEN de la configuración de MCP. No deje una pantalla de consentimiento externa en modo de prueba: sus tokens de actualización caducan a los siete días.

Claude Desktop

Las versiones actuales de Claude Desktop usan extensiones. Ejecute npm run package y luego instale build/adsense-mcp.mcpb desde Configuración → Extensiones → Configuración avanzada → Instalar extensión. Solicita de forma segura los valores de OAuth. En instalaciones que admiten la configuración clásica, añada esto en su lugar:

{
  "mcpServers": {
    "adsense": {
      "command": "node",
      "args": ["/absolute/path/to/adsense-mcp/dist/index.js"],
      "env": {
        "ADSENSE_CLIENT_ID": "...",
        "ADSENSE_CLIENT_SECRET": "...",
        "ADSENSE_REFRESH_TOKEN": "..."
      }
    }
  }
}

Codex

Añada la definición de servidor equivalente a su configuración de MCP de Codex, usando el mismo comando, argumentos y variables de entorno. El servidor utiliza el transporte stdio estándar de MCP y funciona en ambos clientes.

Herramientas

• adsense_list_accounts

• adsense_get_account

• adsense_generate_report

Ejemplo de solicitud de informe: metrics: ["ESTIMATED_EARNINGS", "PAGE_VIEWS", "CLICKS"], dimensions: ["DATE", "COUNTRY_NAME"], dateRange: "LAST_7_DAYS", orderBy: ["-ESTIMATED_EARNINGS"].

Verificación

npm test
npm run build

La verificación en vivo también requiere los valores de OAuth anteriores y una cuenta de AdSense. El endpoint de informes de la API es GET /v2/{account}/reports:generate; requiere el alcance OAuth de AdSense o el de solo lectura de AdSense.

Licencia

MIT