Fangx-AI/geo-doctor
GEO 医生：一句话装进 AI 助手，查清豆包、DeepSeek、ChatGPT、Claude 为什么不推荐你，改资料、写内容、再复查。开源中英双语 GEO（生成式引擎优化）skill。
🩺 GEO 의사 – AI 기반 SEO / GEO 최적화 도구
정의 – AI 어시스턴트 플랫폼(Claude Code, Codex, Kimi Code, WorkBuddy 등)에 설치할 수 있는 오픈소스 스킬(플러그인)입니다. 설치 후 "GEO를 도와줘"와 같은 단일 명령으로 어시스턴트와 대화할 수 있으며, 스킬은 8단계 워크플로를 실행합니다:
- 진단: 주요 AI 크롤러(ChatGPT, Claude, DeepSeek 등)가 귀하의 웹사이트를 읽을 수 있는지 확인합니다.
- 수집: 사이트에서 사실 데이터를 수집하고 "팩트 카드"를 구축합니다.
- 생성: 사용자가 AI에게 제품에 대해 물어볼 수 있는 현실적인 질문을 생성합니다.
- 샘플링: 해당 AI가 실제로 반환하는 답변을 샘플링합니다(답변을 붙여넣거나 스킬이 자동으로 API를 호출).
- 분석: 추천율을 분석하고, 대신 제안되는 경쟁 제품을 나열하며, 누락된 콘텐츠를 식별합니다.
- 작성: 검증된 사실만 사용하여 갭을 직접 해결하는 SEO 친화적인 카피(FAQ, 비교 페이지, 블로그 게시물)를 작성합니다.
- 게시: 새 페이지를 자체 사이트, 생성된 "팩트 사이트" 또는 타사 플랫폼(WordPress, dev.to, Zhihu 등)에 게시합니다.
- 재테스트: 일주일 후 재테스트하여 추천율이 개선되었는지 확인하고, GitHub Action을 통해 전체 루프를 자동화할 수 있습니다.
전체 프로세스는 중국 및 국제 제품이 AI 챗봇과 검색 크롤러에 추천되도록 돕기 위해 설계되었습니다.
📦 설치 (서버 불필요)
- 원라인 스킬 설치 – 지원되는 AI 어시스턴트에서 새 대화를 시작하고 다음을 보냅니다:
이 스킬을 설치하세요: https://github.com/Fangx-AI/geo-doctor/tree/master/skills/geo-doctor
- 스킬은 플랫폼의 플러그인 마켓플레이스에서 추가하거나,
skills/geo-doctor폴더를 적절한 로컬 디렉토리에 복사하거나, 릴리스된geo-doctor.zip을 업로드하여 추가할 수도 있습니다. - 설치 후 "GEO를 도와줘"라고 말하면 워크플로가 시작됩니다.
- 커맨드 라인을 선호하는 사용자를 위해 저장소는 단일 명령 진입점을 제공합니다:
npx github:Fangx-AI/geo-doctor <url> --phrase "關鍵正文"
스킬을 설치하지 않고 AI 크롤러 감사를 실행합니다.
🛠️ 핵심 기능
| 기능 | 설명 | 중요성 |
|---|---|---|
| AI 크롤러 감사 | robots.txt, noindex, canonical 태그, sitemap, 구조화된 데이터 및 주요 AI 크롤러 9개에 대해 원시 HTML에 읽을 수 있는 텍스트가 포함되어 있는지 확인합니다. | 사이트가 AI 어시스턴트에게 기술적으로 보이는지 보장합니다. |
| 팩트 카드 생성 | 사이트, 가격 페이지, 문서에서 검증된 제품 사실을 추출하고 불일치를 플래그합니다. | 이후 카피 생성을 위한 단일 진실 소스를 제공합니다. |
| 질문 세트 생성 | 20~30개의 현실적인 사용자 쿼리를 합성한 다음 핵심 세트 약 10개를 선택합니다. | 사용자가 AI에게 제공할 실제 프롬프트를 반영합니다. |
| 자동 샘플링 | DeepSeek, Qwen, ChatGPT, Claude 등을 호출(또는 수동 답변 붙여넣기)하고 모든 응답을 저장합니다. | 추천율을 계산하는 데 사용할 원시 데이터를 제공합니다. |
| 갭 분석 및 처방 | 경쟁 제품을 순위화하고, 어떤 질문에서 승리하는지 보여주며, 누락된 콘텐츠 체크리스트를 생성합니다. | |
| 일괄 콘텐츠 작성 | 갭당 하나의 기사를 생성하고, 자리 표시자, 과장, 검증되지 않은 사실을 자동으로 확인합니다. | |
| 원클릭 게시 | 정적 사이트, WordPress, GitHub Pages에 배포하고, Zhihu, Juejin 등에 대한 형식화된 초안을 준비합니다. | |
| 지속적 재테스트 | 변경 후 동일한 질문을 다시 확인하고, 전후 보고서를 생성하며, GitHub Action을 통해 매주 예약할 수 있습니다. | |
| 배지 및 공유 카드 | SVG/PNG 배지(예: AI 크롤러 점수 80/100)와 사이트에 포함할 수 있는 소셜 미디어 카드를 생성합니다. |
🚀 스킬 설치 없이 빠른 시작
npx github:Fangx-AI/geo-doctor https://example.com/page --phrase "關鍵功能描述"
- 0~100점, 문제 목록, 선택적 배지/코드 스니펫을 출력합니다.
- Node.js가 없는 환경을 위해 Bash(
toolkit/geo-audit.sh) 및 PowerShell(toolkit/geo-audit.ps1) 버전이 제공됩니다.
📚 문서 및 커뮤니티
- 핸드북 – 전체 단계별 가이드, 다양한 제품 유형에 대한 플레이북, 일반적인 GEO 함정 목록. (
docs/handbook.md) - CI 통합 – 모든 푸시에 대해 감사를 실행하는 GitHub Action. (
docs/quickstart.md) - 준수 가이드 – 스팸성 또는 불법 콘텐츠 생성을 피하기 위한 규칙. (
skills/geo-doctor/references/compliance.md) - 리더보드 – AI 크롤러를 차단하는 중국 사이트의 공개 목록. (
docs/ai-crawler-leaderboard.md) - 기여를 환영합니다(새 플랫폼 사례, 프롬프트 추가, 문서 수정). PR을 권장합니다.
🛡️ 안전 및 제한
- 감사 스크립트는 제로 의존성이며 지정된 URL과 해당
robots.txt/sitemap.xml에만 접근합니다. 제3자에게 데이터가 전송되지 않습니다. - 도구는 AI가 귀하의 제품을 추천할 것을 보장하지 않습니다. 추천을 방해하는 기술적 및 콘텐츠 갭을 해결하는 데 도움을 줄 뿐입니다.
- 대량 게시는 초안 준비로 제한됩니다. Zhihu나 WeChat과 같은 플랫폼에 실제 게시는 계정 정지를 피하기 위해 수동으로 수행해야 합니다.
- API를 노출하는 플랫폼(DeepSeek, ChatGPT 등)에서 자동 샘플링하려면 API 키가 필요합니다.
📄 라이선스
- 코드 – MIT 라이선스
- 문서 및 템플릿 – 크리에이티브 커먼즈 저작자표시 4.0 (CC-BY-4.0)
🎯 대상 사용자
- AI 채팅봇(국내: 두바오, DeepSeek, 해외: ChatGPT/Claude)에 의존하는 제품 팀.
- 커스텀 크롤러를 구축하지 않고 AI 검색 가시성(GEO 최적화)을 개선하려는 마케팅 엔지니어.
- AI 어시스턴트 작업 공간에 플러그 앤 플레이 스킬을 추가하려는 개발자.
결론: GEO 의사는 AI 어시스턴트 프롬프트를 반복 가능한 SEO 스타일 워크플로로 전환하여 AI 어시스턴트가 제품을 표시하지 않는 이유를 발견하고 수정할 수 있는 도구를 제공하는 실용적이고 오픈소스인 자동화 스위트입니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트