GoAnyAPI MCP

English | 中文

Conecta los datos del sitio web y las capacidades de búsqueda de GoAnyAPI a clientes de IA a través del Model Context Protocol (MCP). Una vez conectado, puedes consultar directamente en lenguaje natural datos como tráfico del sitio web, puntuación de dominio, backlinks, SERP, Autocomplete, etc., y la IA seleccionará la herramienta adecuada según la pregunta.

Comenzar

1. Obtener una API Key

1. Inicia sesión en goanyapi.com.

2. En la página de API Key de la consola, crea y copia tu API Key.

3. Asegúrate de que la cuenta tenga créditos disponibles.

La API Key solo debe guardarse en tus variables de entorno o en la gestión de secretos del cliente. No la subas a repositorios de código, capturas de pantalla ni archivos de configuración públicos.

2. Configurar la API Key

macOS / Linux:

export GOANYAPI_API_KEY="你的 GoAnyAPI API Key"

Windows PowerShell:

$env:GOANYAPI_API_KEY="你的 GoAnyAPI API Key"

La sintaxis anterior solo afecta a la ventana actual de PowerShell. Si deseas que la variable de entorno de usuario sea persistente en Windows, puedes usar:

[Environment]::SetEnvironmentVariable("GOANYAPI_API_KEY", "你的 GoAnyAPI API Key", "User")

Después de configurar la variable de entorno persistente, debes reabrir la terminal y reiniciar Codex, Claude Code o Cursor. Los clientes ya en ejecución no leerán automáticamente la nueva variable de entorno.

Si el cliente de IA tiene permisos de operación de terminal, también puedes configurar la variable de entorno de la API Key mediante conversación. Por ejemplo:

请将我提供的 GoAnyAPI API Key 设置为当前 Windows 用户的持久环境变量 GOANYAPI_API_KEY。
请不要在回复中回显 API Key，也不要把它写入项目文件、MCP 配置文件或 Git 仓库。
设置完成后，仅验证环境变量已存在，然后帮我检查 goanyapi MCP 配置。

La API Key debe proporcionarse mediante la entrada segura del cliente o un gestor de claves local. No la pegues directamente en conversaciones públicas. La configuración mediante conversación requiere que el usuario autorice las operaciones de terminal y variables de entorno.

3. Dirección del servicio MCP

Dirección oficial del servicio MCP:

https://mcp.goanyapi.com/mcp

El servicio utiliza autenticación Bearer Token. El cliente debe enviar:

Authorization: Bearer <GOANYAPI_API_KEY>

Related MCP server: SE Ranking MCP Server

Conectar con clientes de IA

Configuración mediante conversación

Si el cliente de IA tiene permisos de operación de terminal y archivos de configuración, puedes completar la integración MCP mediante conversación, no limitado a Codex. Por ejemplo, en un cliente de IA que admita operaciones conversacionales, envía:

请帮我接入 GoAnyAPI MCP。
服务地址：https://mcp.goanyapi.com/mcp
认证方式：从环境变量 GOANYAPI_API_KEY 读取 Bearer Token。
请根据当前 AI 客户端的 MCP 配置格式完成配置，验证 goanyapi 已启用，并且不要把真实 API Key 写入配置文件。

La configuración mediante conversación requiere que el usuario autorice las operaciones de terminal y archivos de configuración. Después de configurar, reabre la terminal y reinicia el cliente, y luego envía solicitudes en lenguaje natural.

Codex

Añade lo siguiente en ~/.codex/config.toml:

[mcp_servers.goanyapi]
url = "https://mcp.goanyapi.com/mcp"
bearer_token_env_var = "GOANYAPI_API_KEY"

Después de reiniciar Codex, estará listo para usar. Codex leerá la clave de la variable de entorno GOANYAPI_API_KEY y añadirá automáticamente el encabezado de autenticación.

Claude Code (cc)

Crea .mcp.json en la raíz del proyecto:

{
  "mcpServers": {
    "goanyapi": {
      "type": "http",
      "url": "https://mcp.goanyapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${GOANYAPI_API_KEY}"
      }
    }
  }
}

Después de iniciar Claude Code, puedes ejecutar /mcp para ver el estado de la conexión, o usar:

claude mcp list

Cursor

Escribe la siguiente configuración en .cursor/mcp.json a nivel de proyecto, o en el archivo de configuración MCP global de Cursor:

{
  "mcpServers": {
    "goanyapi": {
      "url": "https://mcp.goanyapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:GOANYAPI_API_KEY}"
      }
    }
  }
}

Después de guardar, recarga Cursor. Cursor leerá la clave de la variable de entorno GOANYAPI_API_KEY.

Uso posible

Una vez conectado, simplemente haz preguntas directamente a la IA, por ejemplo:

查询 github.com 的网站流量和主要流量来源。

查询 github.com 的域名评分和外链数据。

使用 Bing SERP API 搜索 ai image，返回广告、自然结果和分页信息。

查询 ai image 的 Google 和 Bing Autocomplete 建议词。

MCP seleccionará la herramienta GoAnyAPI correspondiente según la solicitud. Para parámetros detallados, campos de retorno y consumo de créditos, consulta la documentación en chino de GoAnyAPI.

Costos y seguridad de datos

• Cada llamada consumirá créditos de la cuenta según las reglas de la API correspondiente.

• La API Key representa los permisos de tu cuenta GoAnyAPI; no la compartas con otros.

• No escribas la API Key real en repositorios Git, historiales de commits ni capturas de pantalla públicas.

• Si ya no usas un cliente, se recomienda eliminar la configuración MCP correspondiente y rotar la API Key.

Preguntas frecuentes

Error 401 o mensaje de no autorizado

Confirma que la API Key sea válida y verifica que el cliente envíe correctamente:

Authorization: Bearer <GOANYAPI_API_KEY>

También confirma que la variable de entorno GOANYAPI_API_KEY se haya configurado antes de iniciar el cliente.

Créditos insuficientes

Inicia sesión en la página de facturación de GoAnyAPI para consultar el saldo de la cuenta y recargar créditos.

El cliente no muestra las herramientas

Confirma que la dirección MCP esté completada como:

https://mcp.goanyapi.com/mcp

Luego reinicia o recarga el cliente correspondiente y verifica el estado de la conexión MCP.

Cómo confirmar que el servicio es accesible

Puedes acceder a la dirección de verificación de salud desde el navegador o la línea de comandos:

https://mcp.goanyapi.com/health

La verificación de salud solo sirve para confirmar que el servicio está en línea. Llamar a herramientas específicas aún requiere una API Key válida.

El sandbox de Windows bloquea solicitudes de red

Si al probar manualmente ves un error similar al siguiente:

curl: (7) Failed to connect to mcp.goanyapi.com port 443

Esto generalmente indica que el sandbox del terminal o del cliente de IA actual bloquea el acceso de red saliente, no que la dirección MCP o la configuración de la API Key sean incorrectas. Primero reinicia el cliente para que el gestor MCP del cliente recargue la configuración; si sigue fallando, verifica si el proxy, el firewall o la red corporativa permiten el acceso a:

mcp.goanyapi.com:443

No desactives todas las restricciones del sandbox solo para probar. Puedes usar la lista blanca de red o los permisos de red controlados que proporciona el cliente, permitiendo solo el acceso a los dominios necesarios.

PowerShell muestra aviso de seguridad de scripts web

Cuando Windows PowerShell 5.1 usa Invoke-WebRequest para solicitar MCP, puede mostrar un aviso pidiendo confirmar la ejecución de scripts web. Este es un aviso del analizador web de PowerShell, no un error de MCP de GoAnyAPI. Para pruebas manuales, puedes usar:

Invoke-WebRequest -UseBasicParsing ...

O usar Invoke-RestMethod / curl.exe para evitar el analizador de scripts web. Cuando MCP devuelve JSON, se recomienda usar Invoke-RestMethod.

¿Es necesario reiniciar el cliente después de cambiar la configuración?

Después de modificar el archivo de configuración MCP o las variables de entorno, el cliente debe recargar la configuración. Algunos clientes admiten reconexión o recarga en caliente, pero para asegurar que el servicio MCP y la API Key estén activos, generalmente se recomienda cerrar completamente y reabrir el cliente:

• Codex: reinicia Codex.

• Claude Code: inicia una nueva sesión y usa /mcp para verificar el estado de la conexión.

• Cursor: recarga la ventana o reinicia Cursor.

• Otros clientes de IA: usa preferentemente las funciones Reload, Reconnect o Restart que proporciona el cliente.

Si el cliente aún no muestra las herramientas, confirma que la dirección MCP, las variables de entorno y la configuración de autenticación sean correctas, y luego recarga o reinicia el cliente.