CrawlRaven MCP

The server lives at mcp.crawlraven.com/mcp and speaks remote HTTP with OAuth authorization code and S256 PKCE. Access tokens last an hour, refresh tokens rotate on each renewal, and grants expire after 90 days. You approve scopes in a browser, and each client sees only the tools its grant covers. Revoking a connection takes one click on the CrawlRaven MCP page.

Four core tools cover the Performance report: get_website_overview for headline KPIs and deltas, get_search_performance for daily rows and previous-period comparisons, list_queries for a bounded query corpus, and list_pages with trend filters. Paid connections can request any window from 1 to 365 days, which removes the 1,000-row export ceiling that pushes long-tail queries out of view.

Two paid tools read the GA4 property already linked to a website. get_analytics_summary returns totals and deltas with filters for landing page, source, country or device, and get_analytics_breakdown splits the same period by content group or channel. The point is to weigh a ranking gain against sessions and key events, not impressions alone.

list_opportunities returns current items with priority, impact and recommendation context. get_prioritized_seo_plan goes further and shows the score, the weight each signal received and the rank change. An agent can pass request-only overrides such as keyword priorities or key events, and those adjustments are never saved back to your workspace.

list_target_keywords returns the durable plan: intended URLs, intent groups, priority and status. get_target_page_alignment compares that plan with the page leading in clicks, and get_page_query_mapping starts from one URL and reports whether each query belongs to this page, another page, or no page. Unassigned targets show up as a list you can act on.

Four paid tools read stored audits without starting new ones. list_site_audits finds recent runs, get_site_audit returns coverage and rule summaries with suggested fixes, list_site_audit_findings returns exact affected URLs and status codes, and compare_site_audits shows what changed between two runs. Partial coverage can make a finding look fixed when it was never rechecked, so the comparison states that caveat.

Paid connections can approve write scopes separately. Updating opportunity status adds one tool, managing target keywords adds two, and managing manual notes directly adds four. Connections that use the approval-based note permission instead can propose a change with plan_annotation_change and wait for you to approve it in CrawlRaven. System and imported events stay read-only either way.