GoAnyAPI MCP

English | 中文

Подключите данные и поисковые возможности GoAnyAPI к AI-клиентам через Model Context Protocol (MCP). После подключения вы сможете запрашивать на естественном языке данные о трафике сайтов, рейтинге доменов, обратных ссылках, SERP, Autocomplete и другие, а AI будет выбирать подходящий инструмент в зависимости от вопроса.

Начало работы

1. Получение API Key

1. Войдите в goanyapi.com.

2. На странице API Key в консоли создайте и скопируйте API Key.

3. Убедитесь, что на аккаунте есть доступные кредиты.

API Key следует хранить только в ваших переменных окружения или в менеджере секретов клиента. Не отправляйте его в репозитории кода, на скриншоты или в публичные конфигурационные файлы.

2. Настройка API Key

macOS / Linux:

export GOANYAPI_API_KEY="你的 GoAnyAPI API Key"

Windows PowerShell:

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

Указанный выше способ действует только для текущего окна PowerShell. Если вы хотите, чтобы переменная окружения Windows действовала постоянно, используйте:

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

После установки постоянной переменной окружения необходимо заново открыть терминал и перезапустить Codex, Claude Code или Cursor — уже запущенные клиенты не будут автоматически считывать новую переменную окружения.

Если AI-клиент имеет права на операции с терминалом, API Key также можно задать через диалог. Например:

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

API Key следует передавать через безопасный ввод клиента или локальный менеджер ключей, не вставляйте его напрямую в публичный диалог. Диалоговая настройка требует авторизации пользователя на операции с терминалом и переменными окружения.

3. Адрес MCP-сервиса

Официальный адрес MCP-сервиса:

https://mcp.goanyapi.com/mcp

Сервис использует аутентификацию Bearer Token, клиент должен отправлять:

Authorization: Bearer <GOANYAPI_API_KEY>

Related MCP server: SE Ranking MCP Server

Подключение к AI-клиентам

Настройка через диалог

Если AI-клиент имеет права на операции с терминалом и конфигурационными файлами, подключение MCP можно выполнить через диалог, и это не ограничивается Codex. Например, в AI-клиенте с поддержкой диалоговых операций отправьте:

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

Диалоговая настройка требует авторизации пользователя на операции с терминалом и конфигурационными файлами. После завершения настройки заново откройте терминал и перезапустите клиент, затем отправляйте запросы на естественном языке.

Codex

Добавьте в ~/.codex/config.toml:

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

После перезапуска Codex можно использовать. Codex будет считывать ключ из переменной окружения GOANYAPI_API_KEY и автоматически добавлять заголовок аутентификации.

Claude Code (cc)

Создайте .mcp.json в корне проекта:

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

После запуска Claude Code можно выполнить /mcp для проверки статуса подключения, а также использовать:

claude mcp list

Cursor

Запишите следующую конфигурацию в проектный .cursor/mcp.json или в глобальный файл конфигурации MCP в Cursor:

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

После сохранения перезагрузите Cursor. Cursor будет считывать ключ из переменной окружения GOANYAPI_API_KEY.

Примеры использования

После успешного подключения просто задавайте вопросы AI, например:

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

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

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

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

MCP будет выбирать соответствующий инструмент GoAnyAPI в зависимости от запроса. Подробные параметры, возвращаемые поля и расход кредитов указаны в документации GoAnyAPI на китайском.

Стоимость и безопасность данных

• Каждый вызов расходует кредиты аккаунта в соответствии с правилами соответствующего API.

• API Key представляет права вашего аккаунта GoAnyAPI, не делитесь им с другими.

• Не записывайте реальный API Key в Git-репозитории, историю коммитов проекта или публичные скриншоты.

• Если вы больше не используете какой-либо клиент, рекомендуется удалить из него конфигурацию MCP и сменить API Key.

Часто задаваемые вопросы

Возвращается 401 или сообщение об отсутствии авторизации

Убедитесь, что API Key действителен, и проверьте, правильно ли клиент отправляет:

Authorization: Bearer <GOANYAPI_API_KEY>

Также убедитесь, что переменная окружения GOANYAPI_API_KEY была задана до запуска клиента.

Возвращается сообщение о недостатке кредитов

Войдите на страницу тарифов GoAnyAPI, чтобы проверить баланс аккаунта и пополнить кредиты.

Клиент не отображает инструменты

Убедитесь, что адрес MCP указан полностью:

https://mcp.goanyapi.com/mcp

Затем перезапустите или перезагрузите соответствующий клиент и проверьте статус подключения MCP.

Как убедиться, что сервис доступен

Вы можете открыть адрес проверки работоспособности в браузере или командной строке:

https://mcp.goanyapi.com/health

Проверка работоспособности служит только для подтверждения, что сервис онлайн; для вызова конкретных инструментов по-прежнему требуется действительный API Key.

Песочница Windows блокирует сетевые запросы

Если при ручном тестировании вы видите ошибку, похожую на следующую:

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

Это обычно означает, что песочница текущего терминала или AI-клиента запрещает исходящий сетевой доступ, а не то, что адрес MCP или API Key настроены неправильно. Сначала перезапустите клиент, чтобы менеджер MCP клиента перезагрузил конфигурацию; если проблема сохраняется, проверьте, разрешает ли прокси, брандмауэр или корпоративная сеть доступ к:

mcp.goanyapi.com:443

Не отключайте все ограничения песочницы ради тестирования. Используйте белый список сети или контролируемые сетевые разрешения, предоставляемые клиентом, разрешая доступ только к нужным доменам.

PowerShell выводит предупреждение безопасности веб-скриптов

При использовании Invoke-WebRequest в Windows PowerShell 5.1 для запроса к MCP может появиться запрос на подтверждение выполнения веб-скриптов. Это предупреждение парсера веб-страниц PowerShell, а не ошибка MCP GoAnyAPI. При ручном тестировании можно использовать:

Invoke-WebRequest -UseBasicParsing ...

Или используйте Invoke-RestMethod / curl.exe, чтобы избежать парсера веб-скриптов. Когда MCP возвращает JSON, рекомендуется использовать Invoke-RestMethod.

Нужно ли перезапускать клиент после изменения конфигурации

После изменения файла конфигурации MCP или переменных окружения клиенту необходимо перезагрузить конфигурацию. Некоторые клиенты поддерживают переподключение или горячую перезагрузку, но чтобы гарантировать, что MCP-сервис и API Key вступили в силу, обычно рекомендуется полностью закрыть и заново открыть клиент:

• Codex: перезапустите Codex.

• Claude Code: запустите новую сессию и проверьте статус подключения с помощью /mcp.

• Cursor: перезагрузите окно или перезапустите Cursor.

• Другие AI-клиенты: в первую очередь используйте функции Reload, Reconnect или Restart, предоставляемые клиентом.

Если клиент по-прежнему не отображает инструменты, убедитесь, что адрес MCP, переменные окружения и конфигурация аутентификации верны, затем перезагрузите или перезапустите клиент.