GoAnyAPI MCP

English | Chinese

Connect GoAnyAPI's website data and search capabilities to AI clients through the Model Context Protocol (MCP). Once connected, you can query website traffic, domain scores, backlinks, SERP, Autocomplete, and other data directly in natural language, and the AI will choose the appropriate tool based on your question.

Getting Started

1. Get an API Key

1. Log in to goanyapi.com.

2. Create and copy an API Key on the API Key page in the console.

3. Make sure your account has available credits.

The API Key should only be stored in your own environment variables or the client's secret management. Do not commit it to a code repository, screenshot, or public configuration file.

2. Set the API Key

macOS / Linux:

export GOANYAPI_API_KEY="你的 GoAnyAPI API Key"

Windows PowerShell:

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

The above only takes effect for the current PowerShell window. To make the environment variable persist for Windows users, you can use:

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

After setting a persistent environment variable, you need to reopen the terminal and restart Codex, Claude Code, or Cursor. Already running clients will not automatically read the new environment variable.

If the AI client has terminal operation permissions, you can also set the API Key environment variable through conversation. For example:

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

The API Key should be provided through the client's secure input or the local key manager. Do not paste it directly into a public conversation. Conversation-based configuration requires user authorization for terminal and environment variable operations.

3. MCP Service Address

Official MCP service address:

https://mcp.goanyapi.com/mcp

The service uses Bearer Token authentication. The client needs to send:

Authorization: Bearer <GOANYAPI_API_KEY>

Related MCP server: SE Ranking MCP Server

Connecting to AI Clients

Configure via Conversation

If the AI client has terminal and configuration file operation permissions, you can complete the MCP integration through conversation, not limited to Codex. For example, send the following in an AI client that supports conversational operations:

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

Conversation-based configuration requires user authorization for terminal and configuration file operations. After configuration is complete, reopen the terminal and restart the client, then send natural language requests.

Codex

Add the following to ~/.codex/config.toml:

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

Restart Codex and it will be ready to use. Codex reads the key from the GOANYAPI_API_KEY environment variable and automatically adds the authentication request header.

Claude Code (cc)

Create .mcp.json in the project root directory:

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

After starting Claude Code, you can run /mcp to check the connection status, or use:

claude mcp list

Cursor

Write the following configuration to the project-level .cursor/mcp.json, or Cursor's global MCP configuration file:

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

Reload Cursor after saving. Cursor reads the key from the GOANYAPI_API_KEY environment variable.

Example Usage

After connecting, simply ask the AI questions directly, for example:

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

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

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

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

MCP selects the corresponding GoAnyAPI tool based on the request. For detailed parameters, return fields, and credit consumption, refer to the GoAnyAPI Chinese documentation.

Cost and Data Security

• Each call consumes account credits according to the rules of the corresponding API.

• The API Key represents your GoAnyAPI account permissions. Do not share it with others.

• Do not write a real API Key into a Git repository, project commit history, or public screenshots.

• If you no longer use a client, it is recommended to remove the MCP configuration from it and rotate the API Key.

FAQ

401 or Unauthorized Errors

Confirm that the API Key is valid and check that the client is correctly sending:

Authorization: Bearer <GOANYAPI_API_KEY>

Also confirm that the GOANYAPI_API_KEY environment variable was set before the client started.

Insufficient Credits

Log in to the GoAnyAPI billing page to check your account balance and top up credits.

Client Does Not Show Tools

Confirm that the MCP address is fully entered as:

https://mcp.goanyapi.com/mcp

Then restart or reload the corresponding client and check the MCP connection status.

How to Verify the Service Is Accessible

You can access the health check address in a browser or from the command line:

https://mcp.goanyapi.com/health

The health check is only used to confirm the service is online. Calling specific tools still requires a valid API Key.

Windows Sandbox Blocks Network Requests

If you see an error like the following during manual testing:

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

This usually means the current terminal or AI client's sandbox blocks outbound network access, not that the MCP address or API Key configuration is wrong. First restart the client so the client's MCP manager reloads the configuration; if it still fails, check whether the proxy, firewall, or corporate network allows access to:

mcp.goanyapi.com:443

Do not disable all sandbox restrictions for testing. You can use the network whitelist or controlled network permissions provided by the client to allow access only to the required domains.

PowerShell Web Script Security Prompt

When Windows PowerShell 5.1 uses Invoke-WebRequest to request MCP, a prompt may appear asking you to confirm web script execution. This is a prompt from PowerShell's web parser, not a GoAnyAPI MCP error. For manual testing, you can use:

Invoke-WebRequest -UseBasicParsing ...

Or switch to Invoke-RestMethod / curl.exe to avoid the web script parser. When MCP returns JSON, Invoke-RestMethod is recommended.

Do I Need to Restart the Client After Configuration Changes?

After modifying the MCP configuration file or environment variables, the client needs to reload the configuration. Some clients support reconnection or hot reload, but to ensure both the MCP service and API Key are in effect, it is usually recommended to fully exit and reopen the client:

• Codex: Restart Codex.

• Claude Code: Start a new session and use /mcp to check the connection status.

• Cursor: Reload the window or restart Cursor.

• Other AI clients: Prefer the Reload, Reconnect, or Restart features provided by the client.

If the client still does not show tools, confirm that the MCP address, environment variables, and authentication configuration are correct, then reload or restart the client.