SurfRank MCP 서버

AI 에이전트가 SurfRank에서 AI 가시성 보고서를 실행하고, 키워드를 조사하고, 경쟁사를 추적하도록 하세요. 채팅창에서 바로 가능합니다.

이 패키지는 SurfRank 공개 API를 Model Context Protocol (MCP) 도구로 노출하므로, Claude Desktop, Claude Code, Cursor, Windsurf, ChatGPT MCP 커넥터 등 MCP 호환 AI 어시스턴트가 사용자를 대신하여 SurfRank를 호출할 수 있습니다.

SurfRank란 무엇인가요?

SurfRank는 브랜드가 AI 답변(ChatGPT, Perplexity, Gemini, Claude, Grok, DeepSeek, Meta AI) 내에서 얼마나 잘 보이는지 측정합니다. 추적 중인 키워드를 각 엔진에 대해 실행하고, 경쟁사와 비교하여 귀하의 언급을 점수화하며, 성과를 높일 수 있는 콘텐츠 기회를 찾아냅니다.

Related MCP server: DataForSEO MCP Server

MCP란 무엇인가요?

Model Context Protocol은 AI 에이전트가 외부 도구를 발견하고 호출할 수 있도록 하는 Anthropic의 개방형 표준입니다. 이 서버를 한 번 설치하면 에이전트가 24가지 새로운 기능을 갖게 됩니다. 플러그인 API, OAuth 번거로움, 복잡한 연결 코드가 필요 없습니다.

연결 후 에이전트에게 요청할 수 있는 작업

💬 "SaaS 산업 분야의 surfrank.ai를 위한 SurfRank 프로젝트를 생성하고, 다음 10개의 키워드를 추적해줘…"

💬 "최신 AI 가시성 보고서 결과가 어때? 어떤 엔진에서 내 브랜드가 누락되었지?"

💬 "competitor.com에 대한 빠른 테스트를 실행하고 내 점수와 비교해줘."

💬 "상위 5개 콘텐츠 기회를 나열하고 가장 영향력이 큰 주제로 기사를 초안 작성해줘."

에이전트가 올바른 도구를 선택하고, 귀하의 키로 SurfRank API를 호출하며, 자연어로 답변합니다. 크레딧은 직접 API를 호출할 때와 동일한 비율로 귀하의 SurfRank 계정에서 차감됩니다.

요구 사항

• Node.js 18 이상 (MCP SDK에서 필요).

• Pay As You Go 플랜의 SurfRank API 키. app.surfrank.ai/api-management에서 생성하세요.

• MCP 호환 클라이언트 (구성 섹션 참조).

설치

npx를 사용하여 즉시 실행 (설치 불필요):

npx -y @surfrank/mcp-server

또는 전역 설치:

npm install -g @surfrank/mcp-server

구성

아래에서 클라이언트를 선택하고 해당 MCP 구성 파일에 스니펫을 붙여넣으세요.

Claude Desktop

Claude Desktop 구성 파일을 편집하세요:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "surfrank": {
      "command": "npx",
      "args": ["-y", "@surfrank/mcp-server"],
      "env": {
        "SURFRANK_API_KEY": "sr_your_key_here"
      }
    }
  }
}

Claude Desktop을 다시 시작하세요. MCP 서버 메뉴에 surfrank가 나타나야 합니다.

Cursor

~/.cursor/mcp.json을 편집하세요 (또는 설정 → MCP → 서버 추가 사용):

{
  "mcpServers": {
    "surfrank": {
      "command": "npx",
      "args": ["-y", "@surfrank/mcp-server"],
      "env": {
        "SURFRANK_API_KEY": "sr_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add surfrank -- npx -y @surfrank/mcp-server
export SURFRANK_API_KEY=sr_your_key_here

Windsurf

~/.codeium/windsurf/mcp_config.json을 편집하세요:

{
  "mcpServers": {
    "surfrank": {
      "command": "npx",
      "args": ["-y", "@surfrank/mcp-server"],
      "env": { "SURFRANK_API_KEY": "sr_your_key_here" }
    }
  }
}

사용 가능한 도구

이 서버는 모든 SurfRank 공개 API 엔드포인트를 도구로 노출합니다(총 24개). 에이전트가 자동으로 이를 발견하므로 프롬프트에 나열할 필요가 없습니다.

각 도구는 https://api.surfrank.ai/api/v1/public/* 아래의 REST 엔드포인트와 1:1로 매핑됩니다.

범위가 지정된 API 키

프로젝트 범위 API 키를 생성하면 MCP 서버는 해당 프로젝트에서만 작동할 수 있습니다. 다른 프로젝트 ID를 참조하는 도구 호출은 SurfRank API에서 403 오류로 거부되며, 오류는 에이전트의 응답에 그대로 표시됩니다.

단일 워크스페이스나 팀원을 단일 브랜드에 연결할 때 권장되는 설정입니다.

크레딧 사용량

크레딧은 직접 API 호출과 동일한 가격 정책에 따라 SurfRank 계정에서 차감됩니다:

모든 도구 응답에는 credits 객체가 포함되어 있어 에이전트(및 사용자)가 실시간으로 사용량을 추적할 수 있습니다.

환경 변수

디버깅

공식 MCP 인스펙터를 사용하여 서버를 직접 확인하세요. 새 클라이언트를 온보딩하거나 연결 문제를 진단할 때 유용합니다:

SURFRANK_API_KEY=sr_your_key_here \
  npx @modelcontextprotocol/inspector npx @surfrank/mcp-server

인스펙터는 브라우저 UI를 열어 도구를 나열하고 AI 에이전트가 하는 것처럼 수동으로 호출할 수 있게 합니다.

보안 참고 사항

• API 키는 생성 시 한 번만 표시되며 SurfRank 서버에 SHA-256 해시로 저장됩니다. 키를 분실하면 취소하고 다시 생성해야 하며 복구할 수 없습니다.

• 자격 증명은 로컬 MCP 구성 파일에 유지됩니다. 이 패키지는 자격 증명을 디스크에 쓰거나 외부로 전송하지 않습니다.

• 각 API 키는 분당 60회 요청으로 속도가 제한됩니다. 초과 시 HTTP 429가 반환됩니다.

링크

• 🌐 SurfRank — surfrank.ai

• 🔑 API 관리 — app.surfrank.ai/api-management

• 📘 공개 API 문서 — API 관리 → 문서 탭

• 🐛 이슈 — github.com/SurfRankAI/mcp-server/issues

• 📦 npm — @surfrank/mcp-server

라이선스

MIT © SurfRank Pte. Ltd. — LICENSE 참조.