GoAnyAPI MCP

English | 한국어

Model Context Protocol(MCP)을 통해 GoAnyAPI의 웹사이트 데이터와 검색 기능을 AI 클라이언트에 연결합니다. 연결 후 자연어로 웹사이트 트래픽, 도메인 평점, 백링크, 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 또는 Cursor의 전역 MCP 구성 파일에 작성하세요:

{
  "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 웹 스크립트 보안 알림

Windows PowerShell 5.1에서 Invoke-WebRequest로 MCP를 요청하면 웹 스크립트 실행 확인을 요구하는 알림이 표시될 수 있습니다. 이는 PowerShell 웹 파서의 알림이며 GoAnyAPI의 MCP 오류가 아닙니다. 수동 테스트 시 다음을 사용할 수 있습니다:

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 주소, 환경 변수 및 인증 구성이 올바른지 확인한 후 다시 로드하거나 재시작하세요.