cloro MCP server
2026년 11월 7일 커밋국가 및 주 단위의 지오타겟팅을 통해 AI 답변 엔진과 Google 검색 또는 뉴스 결과를 스크래핑합니다.
다른 이름 cloro-dev/mcp-server, mcp-server
- 스타
- 0
- Tools
- 9
- 다운로드, 30일
- —
- 최신 버전
- 0.5.0
- 마지막 커밋
- 2026년 11월 7일
- 라이선스
- MIT
cloro MCP란?
국가 및 주 단위의 지오타겟팅을 통해 AI 답변 엔진과 Google 검색 또는 뉴스 결과를 스크래핑합니다. 9개 도구를 제공합니다. 예: scrape_chatgpt, scrape_gemini, scrape_google_ai_mode.
프로젝트 README에서 생성된 요약
cloro MCP server 정보
cloro는 MCP 클라이언트를 사용하는 개발자가 국가 및 주 단위의 지오타겟팅을 활용하여 AI 답변 엔진과 Google 검색 또는 뉴스 결과를 스크래핑할 수 있도록 지원합니다. 이 MCP server를 통해 에이전트는 표준 Google 웹 검색 및 뉴스 결과와 더불어 ChatGPT, Gemini, Google AI Mode, Google AI Overview, Bing AI Mode의 데이터에 접근할 수 있습니다. Claude, Cursor, Codex와 함께 사용하도록 설계되었으며, 서로 다른 AI 응답을 비교하거나 특정 지리적 영역을 조사하는 용도로 적합합니다.
사용자는 Claude의 경우 OAuth를, other 클라이언트의 경우 API 키를 사용하여 mcp.cloro.dev의 호스팅 엔드포인트로 연결할 수 있습니다. 또한 stdio를 통해 로컬에서 실행할 수도 있습니다. 실시간 정보 수집을 위해 scrape_chatgpt, scrape_google, scrape_google_news와 같은 특화된 도구를 제공합니다. 정밀한 조사를 위해 특정 국가 및 미국 주를 타겟팅하는 기능을 지원하며, Google 리다이렉트 링크를 최종 목적지 URL로 변환하는 유틸리티도 포함되어 있습니다.
활용 사례
- 1AI 엔진 응답 비교에이전트에게 Google의 상위 결과와 ChatGPT가 제공하는 특정 답변을 비교하도록 요청합니다.
- 2지오타겟팅 조사 수행특정 국가 또는 미국 주로 필터링된 검색 결과나 AI 결과를 가져옵니다.
- 3검색 리다이렉트 해결리다이렉트 링크를 사용하는 Google 검색 결과의 실제 목적지 URL을 찾습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
cloro MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 cloro MCP 설치
$ claude mcp add --transport http mcp-server https://mcp.cloro.dev/mcpCursor에 cloro MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"url": "https://mcp.cloro.dev/mcp"
}
}
}VS Code에 cloro MCP 설치
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "http",
"url": "https://mcp.cloro.dev/mcp"
}
}
}VS Code CLI에 cloro MCP 설치
$ code --add-mcp '{"name":"mcp-server","type":"http","url":"https://mcp.cloro.dev/mcp"}'Codex에 cloro MCP 설치
$ codex mcp add mcp-server --url https://mcp.cloro.dev/mcpCodex config.toml에 cloro MCP 설치
~/.codex/config.toml
[mcp_servers.mcp-server] url = "https://mcp.cloro.dev/mcp"
Gemini CLI에 cloro MCP 설치
$ gemini mcp add -s user --transport http mcp-server https://mcp.cloro.dev/mcpGemini settings.json에 cloro MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"url": "https://mcp.cloro.dev/mcp",
"type": "http"
}
}
}cloro MCP 도구 9
README에서 감지됨scrape_chatgptscrape_geminiscrape_google_ai_modescrape_bing_aimodescrape_googlescrape_google_newsresolve_google_redirectlist_countrieslist_states
| scrape_chatgpt | — | |
| scrape_gemini | — | |
| scrape_google_ai_mode | — | |
| scrape_bing_aimode | — | |
| scrape_google | — | |
| scrape_google_news | — | |
| resolve_google_redirect | — | |
| list_countries | — | |
| list_states | — |
구성
MCP_TRANSPORT
| 이름 | 설명 | 유형 |
|---|---|---|
| MCP_TRANSPORT | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능cloro-dev/mcp-server is public and reachablegithub.com/cloro-dev/mcp-server ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-07github.com/cloro-dev/mcp-server ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음9 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답initialize answered with protocol 2025-06-18 in 740 ms통과
README
GitHub에서 보기cloro MCP Server
A Model Context Protocol (MCP) server for cloro, the LLM scraping API that includes a Google SERP API. It gives Claude, Codex, Cursor and any MCP client answers from ChatGPT, Gemini, Google AI Mode, Google AI Overview and Bing AI Mode, plus Google web search and Google News results. Ask your agent "compare Google's top results for best LLM scraping API with ChatGPT's answer" and it calls cloro and reasons over the parsed results and cited sources.
Runs hosted at mcp.cloro.dev, or locally over stdio.
How do you connect an agent to the cloro MCP server?
In Claude, you sign in with OAuth and do not need a key:
- Go to Customize → Connectors and select Add custom connector.
- Enter
https://mcp.cloro.dev/mcp. Under Authentication, choose Sign in when needed. - Ask Claude to use a cloro tool. Sign in to cloro and select the organization whose credits pay for the calls.
Other clients use a cloro API key from the dashboard. The hosted server speaks Streamable HTTP. Put the key in the URL path so it works in clients that cannot set custom headers:
{
"mcpServers": {
"cloro": {
"type": "http",
"url": "https://mcp.cloro.dev/YOUR_CLORO_API_KEY/mcp"
}
}
}
If your client can set headers, use https://mcp.cloro.dev/mcp with Authorization: Bearer YOUR_CLORO_API_KEY. In Claude Code:
claude mcp add --transport http cloro https://mcp.cloro.dev/YOUR_CLORO_API_KEY/mcp
In Cursor
This repo is also a Cursor plugin. Install it from the Cursor marketplace, or point Cursor at the repo, and Cursor prompts for one variable:
| Variable | Value |
|---|---|
CLORO_API_KEY |
Your key from the dashboard |
Cursor stores the key on its side and sends it as Authorization: Bearer, so the key stays out of the URL and out of the repo. The manifest is .cursor-plugin/plugin.json and the server definition is mcp.json.
Running it yourself
npm install
npm run build
MCP_TRANSPORT=stdio CLORO_API_KEY=your_key node dist/index.js
MCP_TRANSPORT is http (default) or stdio. In stdio mode the client spawns the process and the key comes from CLORO_API_KEY; in http mode keys arrive per request and no key is configured on the server. PORT defaults to 8095 and CLORO_API_URL to https://api.cloro.dev.
OAuth is off unless you set CLERK_ISSUER. The hosted server sets it to https://clerk.cloro.dev. api.cloro.dev accepts only tokens from that issuer, so a self-hosted server that forwards to it must use the same value. MCP_PUBLIC_URL (default https://mcp.cloro.dev) sets the resource URL in the protected resource metadata.
What tools does it expose?
| Tool | Endpoint |
|---|---|
scrape_chatgpt |
POST /v1/monitor/chatgpt |
scrape_gemini |
POST /v1/monitor/gemini |
scrape_google_ai_mode |
POST /v1/monitor/aimode |
scrape_bing_aimode |
POST /v1/monitor/bing/aimode |
scrape_google |
POST /v1/monitor/google |
scrape_google_news |
POST /v1/monitor/google/news |
resolve_google_redirect |
POST /v1/monitor/google/goto |
list_countries |
GET /v1/countries |
list_states |
GET /v1/states |
The assistant tools take a prompt and a country (ISO 3166-1 alpha-2), plus an optional state for US state-level targeting. The Google tools take gl for the result geography and an optional hl for the interface language; country still works as a deprecated alias for gl. scrape_google_ai_mode targets sub-country with location or uule rather than state. scrape_google runs either from a query plus gl, or from a complete google.com/search URL that carries the query and pagination itself, and accepts include.aioverview for Google's AI Overview. Every tool takes an optional include object for heavier payload fields; leave it unset for the leanest response.
A Google result link can come back empty, or as a google.com/goto URL, with a redirectLink beside it. Pass the redirectLink to resolve_google_redirect to get the destination.
There is no Grok tool. Grok is discontinued: grok.com shows a sign-up wall to logged-out visitors, and the cloro API rejects Grok calls with a 400 (MODEL_UNAVAILABLE).
There are no Copilot or Perplexity tools. Both are discontinued: they block access for logged-out sessions, and the cloro API rejects their calls with a 400 (MODEL_UNAVAILABLE). These calls cost no credits.
How it works
The server holds no business logic and no secrets. Each request forwards the caller's own credential, an API key or an OAuth access token, to api.cloro.dev as a Bearer token, so authentication, credit billing, rate limiting and concurrency are all enforced by the API rather than here. In http mode every POST builds a fresh server and transport bound to that caller's credential, which is why one deployment serves everyone with no session state.
initialize and tools/list answer without a credential, so a client can list the tools before sign-in. The first tools/call without one returns 401 with a WWW-Authenticate header that points at /.well-known/oauth-protected-resource/mcp. An OAuth client reads the authorization server from there and runs the flow. The server checks a token's signature against the issuer's public JWKS (code in src/oauth-tokens/), so it needs no Clerk secret.
Tool input schemas are the same zod schemas the API validates with, vendored into src/schemas/ from cloro's backend. They are copied rather than imported because that package is not published. The API reference is authoritative if the two ever disagree.
FAQ
Do I need to self-host this?
No. mcp.cloro.dev is hosted and is the path most people should take. This repo exists so you can read what runs, and self-host if your setup calls for it.
Does it cost credits?
Yes. The scrape tools call the sync API, so each call costs the API rate plus a 2-credit sync surcharge. For example, a ChatGPT call costs 7 credits (5 + 2). Each tool description states its cost, and each result returns the credits charged and remaining. resolve_google_redirect costs 1 credit, with no surcharge. list_countries and list_states read fixed reference lists and charge nothing. See pricing.
Why is my API key in the URL?
Because several MCP clients cannot set custom headers. If yours can, use the Authorization header form instead and keep the key out of the path. If your client supports OAuth, use that and there is no key at all. The URL path accepts API keys only, never OAuth tokens.
What is the request timeout?
320 seconds. Sync scrapes can take up to five minutes server-side, so the client budget leaves headroom. For long-running batches use the async task API rather than MCP.
Are there agent skills for cloro?
Yes. cloro-dev/skills has one skill per surface (ChatGPT, Gemini, Google AI Mode, Google AI Overview, Google Search, Google News) and skills for SERP research, LLM answer monitoring and AI visibility tracking. Install them with npx skills add cloro-dev/skills. The skills tell the agent which tool or endpoint to call, what it costs, and how to read the result. They work with this server or with the REST API.
Learn more
- Integration guide: cloro.dev/docs/integrations/mcp
- API reference: cloro.dev/docs
- Agent skills: github.com/cloro-dev/skills
License
MIT. See LICENSE.
cloro MCP 질문
cloro MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --transport http mcp-server https://mcp.cloro.dev/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
cloro MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
cloro MCP는 어떤 도구를 제공하나요?
9개 도구를 제공합니다. 예: scrape_chatgpt, scrape_gemini, scrape_google_ai_mode, scrape_bing_aimode, scrape_google.
직접 호스팅해야 하나요?
아니요, 대부분의 사용자에게는 mcp.cloro.dev에서 제공하는 호스팅 버전을 사용하는 것을 권장합니다.
스크래핑 도구 사용 시 크레딧이 소모되나요?
네, 각 스크래핑 도구 호출 시 API 요금과 함께 2 크레딧의 동기화 추가 비용이 발생합니다.
왜 URL에 API 키가 포함되어 있나요?
일부 MCP 클라이언트는 커스텀 헤더를 설정할 수 없으므로, 해당 경우를 위해 URL 경로를 통한 API 키 인증을 지원합니다.
서버의 요청 타임아웃은 얼마인가요?
최대 5분이 소요될 수 있는 동기식 스크래핑을 지원하기 위해 요청 타임아웃은 320초로 설정되어 있습니다.