StackScan MCP server

웹사이트가 무엇으로 구동되는지, 그리고 그 뒤에 누가 있는지 어시스턴트에게 물어보세요.

StackScan Tech Lookup API를 위한 Model Context Protocol 서버입니다. Claude, Cursor 또는 다른 MCP 클라이언트를 연결하면 다음과 같은 질문을 할 수 있습니다:

example.com은 무엇으로 구축되었나요?

vercel.com 뒤에는 누가 있나요? 그들은 어디에 있고, 어떤 업계이며, LinkedIn은 무엇인가요?

Klaviyo를 사용하는 사이트는 몇 개이며, 어느 국가에 있나요?

설계상 읽기 전용입니다. 여기 있는 어떤 것도 귀하의 시스템에 쓰지 않습니다.

설치

StackScan 계정이 필요합니다. 로그인하고 대시보드에서 API 토큰을 열고 토큰을 생성한 후 같은 페이지에서 작업공간 UUID를 복사하세요.

Claude Desktop (확장 프로그램)

stackscan.mcpb를 릴리스 페이지에서 다운로드한 다음 설정 > 확장 프로그램으로 끌어다 놓으세요. API 토큰과 작업공간 ID를 묻고 나머지는 스스로 설치합니다.

Claude Desktop (수동 구성)

설정 → 개발자 → 구성 편집으로 이동한 후 다음을 추가하세요:

{
  "mcpServers": {
    "stackscan": {
      "command": "npx",
      "args": ["-y", "@stackscan/mcp-server"],
      "env": {
        "STACKSCAN_API_TOKEN": "your-token",
        "STACKSCAN_TENANT_ID": "your-workspace-uuid"
      }
    }
  }
}

Claude Desktop을 다시 시작하세요. 도구가 커넥터 아이콘 아래에 나타납니다.

Claude Code

claude mcp add stackscan \
  --env STACKSCAN_API_TOKEN=your-token \
  --env STACKSCAN_TENANT_ID=your-workspace-uuid \
  -- npx -y @stackscan/mcp-server

Cursor, Windsurf 및 기타

동일한 형태입니다: command: npx, args: ["-y", "@stackscan/mcp-server"], 그리고 두 개의 환경 변수. 구성 파일이 어디에 있는지 클라이언트의 MCP 문서를 확인하세요.

Related MCP server: mcp-gtm-tech-stack-signal-scraper

도구

결과를 찾지 못한 조회는 청구되지 않습니다. check_credits도 마찬가지입니다.

폭과 깊이

기술 도구는 두 가지이며 서로 다른 질문에 답합니다. lookup_domains_technologies는 폭 관점입니다: 여러 도메인, 기술 이름만, "이 중 어떤 것이 Shopify를 사용하나요?"에 적합합니다. lookup_domain_technologies는 깊이 관점입니다: 하나의 도메인, 각 기술의 카테고리와 전 세계 사용 사이트 수. 배치 도구는 도메인별로 생략한 기술 수를 보고하므로 모델이 세부 조사를 제안할 수 있습니다.

배치 도구가 20개에서 멈추는 이유

그 뒤에 있는 REST 엔드포인트는 요청당 100개 도메인을 처리하지만, 이 도구들은 의도적으로 그렇게 하지 않습니다. 도구 결과는 모델의 컨텍스트에 직접 들어가며, 100개의 전체 회사 페이로드는 수만 개의 토큰이 되어 실제 대화를 방해하고, 모델은 무엇이든 답하려면 그 모든 것을 다시 읽어야 합니다. 20개의 간결한 행은 모델이 추론할 수 있는 표입니다.

또한 잘라내기보다는 거부합니다. 배치 비용이 세션 상한을 초과하면 아무것도 청구하지 않고 얼마나 감당할 수 있는지 알려줍니다. 조용히 도메인을 누락하면 완전해 보이지만 실제로는 그렇지 않은 답을 돌려주게 됩니다.

정말로 수백 개의 도메인이 필요하다면 REST 엔드포인트가 그 용도입니다.

구성

세션 상한은 지출 상한이며 의도적입니다

StackScan 자체 한도는 속도 한도입니다: 분당 요청 수. 이는 폭주를 막습니다. 그러나 오후 내내 조용히 전체 크레딧 잔액을 소비하는 인내심 있는 에이전트를 막지는 못합니다. 이는 버튼을 클릭하는 인간에게는 없는 실패 모드입니다.

따라서 이 서버는 자체 카운터를 유지합니다: 기본적으로 세션당 크레딧을 소비하는 조회 25회이며, 이후에는 거부하고 이유를 설명합니다. 실패한 조회와 check_credits는 청구되지 않으므로 카운터에 포함되지 않습니다. 모든 성공적인 결과에는 남은 조회 수와 마지막으로 알려진 잔액을 표시하는 바닥글이 포함되어, 모델이 한도에 부딪혀 발견하는 대신 스스로 속도를 조절할 수 있습니다.

더 높이려면 나중에 알게 되는 대신 의도적으로 ("STACKSCAN_SESSION_LOOKUP_CAP": "200") 올리세요.

개발

npm install
npm run build

test-stdio.mjs는 실제 stdio 파이프를 통해 서버를 구동하는 최소한의 JSON-RPC 클라이언트로, MCP 호스트 없이 테스트할 수 있습니다:

export STACKSCAN_API_TOKEN=...
export STACKSCAN_TENANT_ID=...
node test-stdio.mjs check_credits lookup_company:stripe.com

이 서버에서 stdout에 절대 쓰지 마세요. stdout은 JSON-RPC 채널입니다. 그 외의 것은 프로토콜을 손상시킵니다. 진단은 stderr로 보냅니다.

소스를 읽는 사람을 위한 참고 사항

업스트림 API에 대한 세 가지 사항이 이 코드를 형성했으며 쉽게 잘못 이해할 수 있습니다:

조회 실패는 HTTP 200이지 404가 아닙니다. API는 "해당 도메인에 대한 데이터 없음"을 200 {"success": false, "error": "No data available"}로 응답합니다. 상태 코드를 신뢰하는 클라이언트는 누락된 페이로드를 읽고 충돌합니다. 모든 응답은 실패와 조회 실패를 구분하는 한 곳을 거치므로 실제 실패만 오류로 보고됩니다.

캐시된 응답도 여전히 청구됩니다. API의 응답 캐시는 데이터베이스를 보호하지 지갑을 보호하지 않습니다: 캐시 창 내의 반복 조회는 동일한 크레딧이 듭니다. 그래서 로컬 잔액은 어떤 호출이 무료였는지 추측하는 대신 모든 적중 시 감소합니다.

두 개의 기본 URL이 활성 상태입니다. API의 홈은 api.stackscan.com/v1/...입니다. 이전 app.stackscan.com/api/v1/... 경로는 여전히 제공되며 의도적으로 리디렉션되지 않습니다. 리디렉션은 POST에서 본문을 떨어뜨리기 때문입니다. 구성이 여전히 이전 호스트를 지정하는 경우 이 서버는 이를 감지하고 이전 경로 형태를 계속 사용하므로 업그레이드해도 문제가 없습니다.

개인정보 처리방침

StackScan의 개인정보 처리방침은 www.stackscan.com/privacy에 있습니다. 이 서버에 대해 구체적으로 의미하는 바는 다음과 같습니다:

수집되는 정보. 조회하는 도메인과 기술 이름이 API 토큰 및 작업공간 ID와 함께 HTTPS를 통해 api.stackscan.com으로 전송됩니다. 그 외에는 아무것도 기기에서 나가지 않습니다. 이 서버는 파일을 읽지 않고, 포트를 열지 않으며, 로컬 저장소를 유지하지 않습니다. 보유하는 유일한 상태는 조회 카운터와 크레딧 잔액이며, 둘 다 메모리에 있으며 프로세스가 종료되면 사라집니다.

사용 및 저장 방법. 조회는 작업공간에 기록되어 크레딧을 측정하고 계정을 지원할 수 있습니다. 결과는 StackScan 자체 크롤 데이터에서 나오며, 사용자가 보낸 어떤 것에서도 나오지 않습니다.

제3자. 검색어는 광고 목적으로 판매되거나 공유되지 않습니다. 정책의 "서비스 제공업체와의 공유"에 명시된 대로 StackScan이 운영하는 인프라 제공업체에 도달하며, 그 외에는 어디에도 도달하지 않습니다.

보존. 정책의 "데이터 보존"에 포함됩니다. 계정을 삭제하면 관련 조회 기록도 함께 삭제됩니다.

연락처. hello@stackscan.com 또는 www.stackscan.com/contact.

링크

• API 참조

• 이것이 무엇인지, 쉬운 영어로

• StackScan

라이선스

MIT. LICENSE를 참조하세요.

라이선스는 이 클라이언트만 다루며, HTTP 요청을 만드는 약 500줄입니다. 도달하는 StackScan 데이터는 유료 서비스이며 라이선스에 포함되지 않습니다.