CrawlRaven MCP

서버는 mcp.crawlraven.com/mcp에 있고, 원격 HTTP에 authorization code와 S256 PKCE를 쓴다. 액세스 토큰은 1시간, 리프레시 토큰은 갱신 때마다 교체되며 승인은 90일 뒤 만료된다. 범위는 브라우저에서 승인하고, 클라이언트는 자기 승인에 포함된 도구만 본다. 연결 해제는 CrawlRaven의 MCP 페이지에서 클릭 한 번이면 된다.

핵심 도구 네 개가 실적 보고서를 다룬다. get_website_overview는 주요 KPI와 증감, get_search_performance는 일별 행과 이전 기간 비교, list_queries는 상한이 있는 검색어 집합, list_pages는 추세 필터가 붙은 페이지 집합을 돌려준다. 유료 연결은 1일에서 365일까지 원하는 기간을 지정할 수 있어, 긴 검색어를 밀어내던 1,000행 한도도 사라진다.

유료 도구 두 개가 사이트에 이미 연결된 GA4 속성을 읽는다. get_analytics_summary는 랜딩 페이지, 유입원, 국가, 기기 필터와 함께 합계와 차이를 내놓고, get_analytics_breakdown은 같은 기간을 콘텐츠 그룹이나 채널로 쪼갠다. 순위 상승을 노출이 아니라 세션과 핵심 이벤트로 저울질하기 위한 구성이다.

list_opportunities는 처리 가능한 항목을 우선순위, 영향도, 권장 배경과 함께 돌려준다. get_prioritized_seo_plan은 점수, 신호별 가중치, 순위 변동까지 보여 준다. 키워드 우선순위나 핵심 이벤트 같은 조정값은 해당 요청에만 적용할 수 있고, 그 값은 워크스페이스에 저장되지 않는다.

list_target_keywords는 오래 쓰는 계획을 돌려준다. 예정 URL, 의도 그룹, 우선순위, 상태가 담긴다. get_target_page_alignment는 그 계획과 클릭을 이끄는 페이지를 비교하고, get_page_query_mapping은 URL 하나에서 출발해 각 검색어가 이 페이지, 다른 페이지, 미배정 중 어디에 속하는지 알려 준다. 페이지가 없는 목표는 목록으로 드러나 바로 처리할 수 있다.

유료 도구 네 개는 저장된 감사를 읽을 뿐 새 감사를 시작하지 않는다. list_site_audits는 최근 실행을 찾고, get_site_audit은 커버리지와 규칙 요약, 수정 제안을 준다. list_site_audit_findings는 영향받은 URL과 상태 코드를, compare_site_audits는 두 실행 사이의 변화를 보여 준다. 커버리지가 일부만 채워지면 다시 확인하지 않은 항목이 고쳐진 것처럼 보일 수 있고, 비교 결과는 그 점을 함께 알린다.

유료 연결은 쓰기 권한을 따로 승인할 수 있다. 기회 상태 관리는 도구 하나, 목표 키워드 관리는 둘, 수동 메모 직접 관리는 넷을 더한다. 승인 방식 메모 권한을 쓰는 연결은 plan_annotation_change로 변경을 제안하고 CrawlRaven에서 승인을 기다린다. 시스템 이벤트와 가져온 이벤트는 두 방식 모두 읽기 전용으로 남는다.