mocop
Browse · Docs · Guide · Analyze

GEOcare REST API

API by GMP.ai · rest

GEOcare.ai 계정 단위 REST API — MCP와 동일한 도구를 표준 HTTP로 제공. 0. 막히거나 처음이면 geo_guide 를 먼저 호출하십시오. GRAND 여정 G1~G7(사이트 등록 → 크롤 → EEAT → SoM → JSON-LD → 모니터링 → 알림)을 단계별 할 일 + 그 단계에서 쓸 도구 + 해당 화면으로 안내합니다. 인자도 비용도 없습니다. 1. list_my_sites — 접근 가능한 사이트 확인. 이후 모든 호출의 site_domain 은 여기서 나온 값을 씁니다. 2. check_pipeline_readiness — 진단 전 사전요건 점검. 조회가 비었을 때 원인 판별에도 씁니다(«데이터 없음»과 «다른 계정 소유라 접근 권한 없음»은 다릅니다 — other_account_count 확인). · 인증: Authorization: Bearer <API_KEY> (또는 ?key=<API_KEY>). geocare.ai → 계정 메뉴 → REST API 에서 발급. · 계정 단위: 키 1개로 접근 가능한 모든 사이트. · 실행형(action) 도구는 confirm: true 인자 필요(2단계 안전장치). · 진단·크롤 발사는 분 단위로 걸립니다. 응답의 ok:true 는 «발사 성공»이지 «완료»가 아닙니다. 결과가 안 보인다고 다시 부르지 마십시오 — 재호출은 월 실행 한도를 또 소진합니다. 응답의 check 필드가 진행 확인 방법(get_som_runs / get_analysis_jobs)을 알려 줍니다. · 실행 응답의 applied 필드는 실제로 적용된 인자입니다. 보낸 값과 다르면 그 값이 서버에서 조정된 것입니다. · 도구가 주지 않은 값은 만들어 쓰지 마십시오. 반환값에 없는 사실(전수 여부·필터 반영 등)을 단정하면 안 됩니다.

Endpoint: https://api.gmp.ai/

Verification: observed. Source: crawl.

Capabilities (49)

  • 경쟁사 추가(기본 = append: 기존 내 경쟁사 목록에 병합 저장). ⚠️ 정본 RPC(save_trial_competitors)는…
  • SoM 질문 직접 추가(수동). queries = 문자열 배열 또는…
  • 분석 발사 전 사전요건 점검(브랜드·경쟁사·질문풀·크롤). 누락 항목 안내.
  • SoM 질문 영구삭제(다건) — ⚠️ 비활성(is_active=false) 질문만 삭제 가능. 활성 질문은 먼저…
  • SoM 질문풀 생성(정본 EF geo-som-querygen). confirm:true 필요.
  • GEOcare 사용 여정(GRAND G1~G7)을 단계별 할 일 + 쓸 MCP 도구 + 화면으로 안내한다. '어떻게 시작해/다음에 뭐 하지'…
  • 이 사이트의 알림 임계값(정책) 조회 — SoM/사이트 점수 하락·상승 기준(pp/점) 운영알림 on/off. (화면 '알림 관리'와 동일…
  • 이 사이트의 현재 알림(🔴위기/🟢기회/🔵운영)을 신호·의미·이슈·추천대응으로 라이브 평가해 반환. SoM·사이트 점수 변화·사전요건·최근…
  • 분석 작업 이력/상태(진행률·현재 단계). 행마다 kind 가 붙는다 — grand_master = GRAND 최상위…
  • 브랜드 평판 지표(GEO/SoM/언급/감성/브랜드파워).
  • AI 인용 출처를 도메인 단위로 집계(자주 인용되는 도메인).
  • AI 응답이 인용한 출처 URL 목록.
  • 경쟁사별 SoM(점유율) 분석 결과 — 내 계정의 최신 분석 회차만 반환(과거·타 계정 데이터 혼입 방지).…
  • 설정된 경쟁사 목록(id·이름·도메인·상태) — 내 계정(+공유받은 소유자) 범위 활성만. ⚠️ id 는…
  • SoM 결과에서 만든 콘텐츠 개선 제안(큐에 들어간 항목)을 조회한다 — 제목·콘텐츠 유형·진행 상태·근거 문구·대상 질문(4개 AI 모두…
  • 페이지별 EEAT 점수(낮은 순=개선 우선).
  • 콘텐츠 EEAT 요약 점수(경험·전문성·권위·신뢰).
  • GEO 점수 스냅샷(SoM/SEO 총점·5대 KPI) 최신 + SoM 점유율.
  • JSON-LD 송출 element 목록(타입·범위·URL).
  • JSON-LD 송출 현황(schema_type별 개수).
  • 내 MCP·REST API 사용량/한도 조회(계정 단위 합산 — site_domain 불필요). 오늘 사용·일일…
  • 플랜/쿼터 상태(tier·trial·월 페이지 쿼터).
  • 생성된 리포트 목록(유형·일자·상태·링크).
  • 사이트의 브랜드 프로파일(브랜드명·별칭·업종·회사명·플랜) — 내 계정(+공유받은 소유자) 데이터만 최신 확정본 우선.
  • SoM 격차 분석(자사 vs 1위 경쟁사·약한 의도/LLM·기회).
About · Contact · Privacy