refd MCP server
2026년 9월 29일 커밋ChatGPT, Perplexity, Google AI Overviews 등 다양한 플랫폼에서 AI 검색 가시성, 경쟁사 언급 및 인용 정보를 추적합니다.
다른 이름 emaitchess/refd
- 스타
- 2
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 0.3.0
- 마지막 커밋
- 2026년 9월 29일
- 라이선스
- MIT
refd MCP란?
ChatGPT, Perplexity, Google AI Overviews 등 다양한 플랫폼에서 AI 검색 가시성, 경쟁사 언급 및 인용 정보를 추적합니다.
프로젝트 README에서 생성된 요약
refd MCP server 정보
refd는 마케팅 팀과 개발자가 AI 모델이 브랜드를 어떻게 논의하는지 모니터링할 수 있도록 지원합니다. 이 도구는 ChatGPT, Perplexity, Gemini, Google AI Overviews를 포함한 플랫폼 전반에서 가시성, 언급, 인용 및 순위를 추적합니다. 이를 통해 브랜드가 인용되고 있는지, 아니면 경쟁사가 AI 생성 답변에서 더 많은 주목을 받고 있는지 확인할 수 있습니다.
사용자는 호스팅된 애플리케이션을 통해 인텔리전스에 접근하거나 Cloudflare Workers, D1, R2를 사용하여 전체 스택을 직접 self-hosting할 수 있습니다. remote MCP connector를 사용하면 AI agent가 이 데이터와 상호작용할 수 있습니다. Cursor 또는 VS Code에서 로컬로 설정하려면 원클릭 설치를 사용할 수 있으며, headless agent는 personal access token을 사용하여 연결할 수 있습니다. Standard 계정은 5개의 워크스페이스, 워크스페이스당 25개의 active prompts, 3개의 활성화된 AI surface로 제한됩니다.
활용 사례
- 1AI 답변 내 브랜드 가시성 추적AI agent에게 ChatGPT 및 Perplexity 결과에서 브랜드가 얼마나 자주 언급되거나 인용되는지 확인하도록 요청합니다.
- 2경쟁사 언급 모니터링자사 브랜드와 비교하여 어떤 경쟁사가 AI 검색 엔진에 의해 추천되고 있는지 분석합니다.
- 3Google AI Overviews 감사특정 산업 관련 프롬프트에 대해 웹사이트가 Google AI Overviews에 표시되는지 확인합니다.
- 4agent를 활용한 브랜드 리포팅 자동화personal access token이 있는 headless AI agent를 사용하여 브랜드 감성 및 인용 데이터를 가져옵니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
refd MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 refd MCP 설치
$ claude mcp add --transport http refd https://api.refd.ai/mcpCursor에 refd MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"refd": {
"url": "https://api.refd.ai/mcp"
}
}
}VS Code에 refd MCP 설치
.vscode/mcp.json
{
"servers": {
"refd": {
"type": "http",
"url": "https://api.refd.ai/mcp"
}
}
}VS Code CLI에 refd MCP 설치
$ code --add-mcp '{"name":"refd","type":"http","url":"https://api.refd.ai/mcp"}'Codex에 refd MCP 설치
$ codex mcp add refd --url https://api.refd.ai/mcpCodex config.toml에 refd MCP 설치
~/.codex/config.toml
[mcp_servers.refd] url = "https://api.refd.ai/mcp"
Gemini CLI에 refd MCP 설치
$ gemini mcp add -s user --transport http refd https://api.refd.ai/mcpGemini settings.json에 refd MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"refd": {
"url": "https://api.refd.ai/mcp",
"type": "http"
}
}
}자동 검사
2026년 11월 15일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능emaitchess/refd is public and reachablegithub.com/emaitchess/refd ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-09-29github.com/emaitchess/refd ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답HTTPS endpoint answered 401 (sign-in required)통과
README
GitHub에서 보기refd
Open-source AI search monitoring — track how AI answers talk about any brand: visibility, mentions, citations, and rank across ChatGPT, Perplexity, Gemini, Google AI Mode, and Google AI Overviews. Use the hosted app at refd.ai or self-host the whole stack.
A Bun-workspace monorepo of three independently deployed Cloudflare Workers: apps/api (api.refd.ai) — the Hono API, OAuth, remote MCP, daily cron, and queue consumer, holding every binding; apps/dashboard (dash.refd.ai) — the React SPA as an assets-only Worker; apps/web (refd.ai) — the static Astro public site. Shared runtime-neutral code lives in packages/core. Data via BrightData (dataset scrapers + SERP API), stored in D1 (Drizzle) with gzipped raw payloads in R2.
refd also exposes the same workspace intelligence to AI agents through a remote
MCP connector. Its default data:read scope is read-only; the optional
data:write scope adds the bounded setup lifecycle, can start one onboarding
report, and can revoke the connection with explicit confirmation. The hosted
guide lives at refd.ai/agents; the
MCP connector guide covers Claude, Claude Code, ChatGPT, generic
clients, personal access tokens for headless agents, and self-hosting setup.
One click from the guide installs it in Cursor or VS Code — or claude mcp add-json refd '{"type":"http","url":"https://api.refd.ai/mcp"}'. Headless agents use a personal access token from Settings → Personal access tokens instead of OAuth.
How it works
Accounts hold workspaces; each workspace tracks one brand — its competitors, its prompt set, its runs. A daily cron creates an idempotent run for every workspace eligible for scheduled monitoring, then fans out queue messages: one batch-snapshot trigger per dataset surface × sample (trigger → notify → fetch, with a backstop poll), plus one sync SERP call per prompt × sample for AI Overviews. Every answer is scored for every tracked entity (mentioned / cited / first-mention position), and the raw payload is archived gzipped in R2. A missing AI Overview is recorded as a valid "no AIO shown", not a failure. Run dispatch persists immutable launch plans and resumes with bounded backoff. Storage converges under queue redelivery, but BrightData has no idempotency key, so a crash after provider acceptance can repeat paid work.
Develop
bun install
bun run dev # applies local migrations, then runs all three Workers behind
# Caddy on same-site subdomains over real HTTPS
Register on the login screen (business email + password ≥ 8 chars) — your first workspace is created automatically and drops you into a resumable setup wizard: name your brand, let it draft your description from your site, pick competitors and prompts, choose engines, then watch the first report fill in live. Every AI step falls back to typing it yourself. Standard accounts can create up to five workspaces, keep up to 25 active prompts in each, and enable up to three AI surfaces. Emails in ADMIN_EMAILS have no workspace or active-prompt cap and can enable all available surfaces.
bun run dev starts Caddy (Caddyfile) fronting all three Workers on same-site subdomains — Astro at https://refdlocal.io, the dashboard at https://dash.refdlocal.io, the API at https://api.refdlocal.io (add all three to /etc/hosts as 127.0.0.1, and run caddy trust once). Real HTTPS on same-site subdomains exercises secure cross-origin cookies, CORS, OAuth redirects, and WebSocket streaming just like production. Caddy stops when dev exits.
Local secrets go in apps/api/.dev.vars (gitignored): JWT_SECRET, BRIGHTDATA_API_TOKEN, BRIGHTDATA_WEBHOOK_SECRET (optional locally; requires a publicly reachable PUBLIC_BASE_URL), ADMIN_EMAILS (comma-separated administrator and operator allowlist), and EXA_API_KEY (onboarding's competitor search, optional). Non-secret build-time origins (VITE_API_ORIGIN, PUBLIC_DASHBOARD_ORIGIN, …) are committed per environment in each app's .env.development / .env.production. Analytics is a self-hosted Umami instance shared by the public site and the dashboard, so the activation funnel can span both: the web app needs PUBLIC_UMAMI_HOST_URL, PUBLIC_UMAMI_WEBSITE_ID, and PUBLIC_ANALYTICS_HOSTNAME, and the dashboard needs the same three as VITE_* (with the same website id). Leave any of them unset and the build emits no tracker at all, which is what a self-hosted deployment wants. Onboarding also uses two bindings, not secrets — Workers AI (AI) and Browser Rendering (BROWSER) — both remote: true in apps/api/wrangler.jsonc, so local dev proxies to the real services and the account needs both enabled.
bun run check— typecheck (all workspaces) ·bun run lint/lint:fix— Biome ·bun test— unit testsbun run build— build all three Workers ·bun run deploy— build, migrate D1, then deploy all three (the self-hosted/manual path; on refd.ai, merging tomaindeploys all three Workers automatically via Cloudflare)
Git worktrees are supported out of the box with wt: wt create <name> runs the checked-in .wt/setup.sh, which installs dependencies and copies local secrets and wrangler state, so a fresh worktree behaves like your main checkout.
Self-host
wrangler queues create refd-ingest && wrangler queues create refd-ingest-dlq
wrangler secret put JWT_SECRET
wrangler secret put BRIGHTDATA_API_TOKEN
wrangler secret put ADMIN_EMAILS # comma-separated admin/operator allowlist
wrangler secret put EXA_API_KEY # optional: onboarding competitor search
bun run db:migrate:remote
bun run deploy
bun run deploy builds all three Workers and deploys them (refd-api, refd-dashboard, refd-web); point their custom domains at api., dash., and the apex. The API workspace's own deploy script runs remote D1 migrations first, so deploying @refd/api alone (CI or a Cloudflare dash deploy command) always brings the schema along. (The hosted deployment wires these deploy scripts to push-to-main via Cloudflare's Git integration, so refd.ai itself has no manual deploy step.) You'll need a Cloudflare account (Workers paid plan for Queues, plus Workers AI and Browser Rendering enabled for onboarding), a D1 database + R2 bucket (ids/names in apps/api/wrangler.jsonc), and a BrightData account: fill the dataset IDs in apps/api/wrangler.jsonc vars (dashboard → Web Scrapers → each AI scraper) and create a SERP API zone matching BRIGHTDATA_SERP_ZONE. Set the deployment origins (PUBLIC_BASE_URL, DASHBOARD_ORIGIN, PUBLIC_SITE_ORIGIN, API_ORIGIN) and SCHEDULED_MONITORING_POLICY=all for a self-hosted deployment; the checked-in entitled policy is for refd.ai and limits cron to active pilot or subscribed workspaces. Cron schedule (daily 06:00 UTC), samples, and geo also live in apps/api/wrangler.jsonc.
Notes
- AI answers are non-deterministic: hosted scheduled runs use
SAMPLES=1per prompt and surface; read trends across completed runs, not one sample. Operators can request additional samples for focused manual runs. - Each standard full run is capped at 25 active prompts × 3 enabled surfaces × samples (25 × 3 × 1 = 75 records at the default). Quota scales with the number of workspaces eligible for scheduled monitoring.
- The public site is built to be read by agents as well as people: every page is also served as markdown at the same path with
.mdappended,/llms.txtfollows the llmstxt.org format and links those markdown versions, and/llms-full.txtinlines them all. Self-hosted deployments get this for free. - Design system:
DESIGN.md. Scoring/metrics contract:docs/METRICS.md. Remote MCP + OAuth:docs/mcp.md.
Contributing
Contributions welcome. See CONTRIBUTING.md for setup and the
checks your PR must pass, and CODE_OF_CONDUCT.md for
community expectations. Found a security issue? Follow SECURITY.md
instead of opening a public issue.
License
MIT © refd
refd MCP 질문
refd MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --transport http refd https://api.refd.ai/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
refd MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
refd로 무엇을 추적할 수 있나요?
ChatGPT, Perplexity, Gemini, Google AI Mode, Google AI Overviews에서 브랜드의 가시성, 언급 횟수, 인용 및 순위를 포함하여 AI 답변이 브랜드를 어떻게 다루는지 추적할 수 있습니다.
AI agent와 refd를 어떻게 함께 사용하나요?
remote MCP connector를 사용하여 워크스페이스 인텔리전스를 AI agent에 노출할 수 있습니다. Headless agent는 Settings 메뉴의 personal access token을 사용할 수 있습니다.
Standard 계정의 제한 사항은 무엇인가요?
Standard 계정은 최대 5개의 워크스페이스를 생성할 수 있으며, 워크스페이스당 최대 25개의 active prompts를 유지하고, 최대 3개의 AI surface를 활성화할 수 있습니다.