mcp-scraper 0.2.19 → 0.2.21

package/docs/mcp-tool-manifest.generated.json

@@ -0,0 +1,1534 @@
+{
+  "generatedAt": "2026-06-17T18:15:10.329Z",
+  "counts": {
+    "main_stdio": 22,
+    "browser_agent_stdio": 21,
+    "combined_stdio": 43,
+    "hosted_http": 24,
+    "hosted_only": 2,
+    "unique_public": 45
+  },
+  "surfaces": {
+    "main_stdio": [
+      "harvest_paa",
+      "search_serp",
+      "extract_url",
+      "map_site_urls",
+      "extract_site",
+      "youtube_harvest",
+      "youtube_transcribe",
+      "facebook_page_intel",
+      "facebook_ad_search",
+      "facebook_ad_transcribe",
+      "facebook_video_transcribe",
+      "maps_place_intel",
+      "maps_search",
+      "directory_workflow",
+      "workflow_list",
+      "workflow_suggest",
+      "workflow_run",
+      "workflow_step",
+      "workflow_status",
+      "workflow_artifact_read",
+      "rank_tracker_blueprint",
+      "credits_info"
+    ],
+    "browser_agent_stdio": [
+      "browser_open",
+      "browser_profile_list",
+      "browser_profile_import",
+      "browser_profile_sync",
+      "browser_profile_onboard",
+      "browser_screenshot",
+      "browser_read",
+      "browser_locate",
+      "browser_goto",
+      "browser_click",
+      "browser_type",
+      "browser_scroll",
+      "browser_press",
+      "browser_replay_start",
+      "browser_replay_stop",
+      "browser_list_replays",
+      "browser_replay_download",
+      "browser_replay_mark",
+      "browser_replay_annotate",
+      "browser_close",
+      "browser_list_sessions"
+    ],
+    "combined_stdio": [
+      "harvest_paa",
+      "search_serp",
+      "extract_url",
+      "map_site_urls",
+      "extract_site",
+      "youtube_harvest",
+      "youtube_transcribe",
+      "facebook_page_intel",
+      "facebook_ad_search",
+      "facebook_ad_transcribe",
+      "facebook_video_transcribe",
+      "maps_place_intel",
+      "maps_search",
+      "directory_workflow",
+      "workflow_list",
+      "workflow_suggest",
+      "workflow_run",
+      "workflow_step",
+      "workflow_status",
+      "workflow_artifact_read",
+      "rank_tracker_blueprint",
+      "credits_info",
+      "browser_open",
+      "browser_profile_list",
+      "browser_profile_import",
+      "browser_profile_sync",
+      "browser_profile_onboard",
+      "browser_screenshot",
+      "browser_read",
+      "browser_locate",
+      "browser_goto",
+      "browser_click",
+      "browser_type",
+      "browser_scroll",
+      "browser_press",
+      "browser_replay_start",
+      "browser_replay_stop",
+      "browser_list_replays",
+      "browser_replay_download",
+      "browser_replay_mark",
+      "browser_replay_annotate",
+      "browser_close",
+      "browser_list_sessions"
+    ],
+    "hosted_http": [
+      "harvest_paa",
+      "search_serp",
+      "extract_url",
+      "map_site_urls",
+      "extract_site",
+      "youtube_harvest",
+      "youtube_transcribe",
+      "facebook_page_intel",
+      "facebook_ad_search",
+      "facebook_ad_transcribe",
+      "facebook_video_transcribe",
+      "maps_place_intel",
+      "maps_search",
+      "directory_workflow",
+      "workflow_list",
+      "workflow_suggest",
+      "workflow_run",
+      "workflow_step",
+      "workflow_status",
+      "workflow_artifact_read",
+      "rank_tracker_blueprint",
+      "credits_info",
+      "capture_serp_snapshot",
+      "capture_serp_page_snapshots"
+    ],
+    "hosted_only": [
+      "capture_serp_snapshot",
+      "capture_serp_page_snapshots"
+    ],
+    "unique_public": [
+      "harvest_paa",
+      "search_serp",
+      "extract_url",
+      "map_site_urls",
+      "extract_site",
+      "youtube_harvest",
+      "youtube_transcribe",
+      "facebook_page_intel",
+      "facebook_ad_search",
+      "facebook_ad_transcribe",
+      "facebook_video_transcribe",
+      "maps_place_intel",
+      "maps_search",
+      "directory_workflow",
+      "workflow_list",
+      "workflow_suggest",
+      "workflow_run",
+      "workflow_step",
+      "workflow_status",
+      "workflow_artifact_read",
+      "rank_tracker_blueprint",
+      "credits_info",
+      "browser_open",
+      "browser_profile_list",
+      "browser_profile_import",
+      "browser_profile_sync",
+      "browser_profile_onboard",
+      "browser_screenshot",
+      "browser_read",
+      "browser_locate",
+      "browser_goto",
+      "browser_click",
+      "browser_type",
+      "browser_scroll",
+      "browser_press",
+      "browser_replay_start",
+      "browser_replay_stop",
+      "browser_list_replays",
+      "browser_replay_download",
+      "browser_replay_mark",
+      "browser_replay_annotate",
+      "browser_close",
+      "browser_list_sessions",
+      "capture_serp_snapshot",
+      "capture_serp_page_snapshots"
+    ]
+  },
+  "tools": [
+    {
+      "name": "harvest_paa",
+      "surfaces": [
+        "main_stdio",
+        "combined_stdio",
+        "hosted_http"
+      ],
+      "tokenBudgetClass": "core",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": true,
+      "symptomTriggers": [
+        "the user needs Google PAA questions, source answers, AI Overview language, or broad SERP research"
+      ],
+      "samplePrompts": [
+        "Find PAA questions for heat pump replacement cost in Denver",
+        "Do a deep PAA harvest for med spa SEO",
+        "What sources does Google use for this topic?"
+      ],
+      "formatExamples": [
+        "query=\"best hvac company\", location=\"Denver, CO\"",
+        "proxyMode=\"location\" only for explicit ZIP/city proxy evidence"
+      ],
+      "negativeSpace": "Use search_serp for quick rankings without PAA expansion; use maps_search for Google Maps business lists.",
+      "producesHandlesFor": [
+        "extract_url"
+      ],
+      "consumesHandles": []
+    },
+    {
+      "name": "search_serp",
+      "surfaces": [
+        "main_stdio",
+        "combined_stdio",
+        "hosted_http"
+      ],
+      "tokenBudgetClass": "core",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": true,
+      "symptomTriggers": [
+        "the user asks for rankings, organic positions, local pack presence, or a quick Google SERP check"
+      ],
+      "samplePrompts": [
+        "Check the SERP for best dentist in Brooklyn NY",
+        "Who ranks for AI SEO tools?",
+        "Show organic positions for this keyword"
+      ],
+      "formatExamples": [
+        "query=\"best dentist\", location=\"Brooklyn, NY\"",
+        "pages=1 normally, pages=2 only for deeper evidence"
+      ],
+      "negativeSpace": "Use harvest_paa when the user needs People Also Ask expansion; use capture_serp_snapshot for hosted SERP Intelligence evidence.",
+      "producesHandlesFor": [
+        "extract_url",
+        "capture_serp_page_snapshots"
+      ],
+      "consumesHandles": []
+    },
+    {
+      "name": "extract_url",
+      "surfaces": [
+        "main_stdio",
+        "combined_stdio",
+        "hosted_http"
+      ],
+      "tokenBudgetClass": "core",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": true,
+      "symptomTriggers": [
+        "the user provides one URL and wants content, schema, metadata, screenshots, branding, or media assets"
+      ],
+      "samplePrompts": [
+        "Extract this landing page",
+        "Get schema and headings from this URL",
+        "Download images from this page"
+      ],
+      "formatExamples": [
+        "url=\"https://example.com/service-page\"",
+        "screenshotDevice=\"mobile\"",
+        "mediaTypes=[\"image\",\"video\"]"
+      ],
+      "negativeSpace": "Use map_site_urls before extracting a whole site; use extract_site for multi-page extraction.",
+      "producesHandlesFor": [
+        "saved-report",
+        "local-screenshot",
+        "local-media"
+      ],
+      "consumesHandles": [
+        "public-url"
+      ]
+    },
+    {
+      "name": "map_site_urls",
+      "surfaces": [
+        "main_stdio",
+        "combined_stdio",
+        "hosted_http"
+      ],
+      "tokenBudgetClass": "core",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": true,
+      "symptomTriggers": [
+        "the user wants a sitemap, URL inventory, broken-link scan, or crawl planning before extraction"
+      ],
+      "samplePrompts": [
+        "Map this website URLs",
+        "Find broken links on this site",
+        "Build a URL inventory before audit"
+      ],
+      "formatExamples": [
+        "url=\"https://example.com\"",
+        "maxUrls=100 for normal maps, maxUrls=500 for full inventory"
+      ],
+      "negativeSpace": "Use extract_url for one known page; use extract_site after mapping when the user wants page content.",
+      "producesHandlesFor": [
+        "extract_url",
+        "extract_site"
+      ],
+      "consumesHandles": [
+        "public-site-url"
+      ]
+    },
+    {
+      "name": "extract_site",
+      "surfaces": [
+        "main_stdio",
+        "combined_stdio",
+        "hosted_http"
+      ],
+      "tokenBudgetClass": "core",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": true,
+      "symptomTriggers": [
+        "the user wants a multi-page site audit, content crawl, competitor crawl, or schema inventory"
+      ],
+      "samplePrompts": [
+        "Extract this site for an SEO audit",
+        "Crawl the top pages of this competitor",
+        "Get titles and schema across the site"
+      ],
+      "formatExamples": [
+        "url=\"https://example.com\"",
+        "maxPages=50 for the MCP limit"
+      ],
+      "negativeSpace": "Use map_site_urls first when the user needs URL selection; use extract_url for one page.",
+      "producesHandlesFor": [
+        "saved-report"
+      ],
+      "consumesHandles": [
+        "public-site-url"
+      ]
+    },
+    {
+      "name": "youtube_harvest",
+      "surfaces": [
+        "main_stdio",
+        "combined_stdio",
+        "hosted_http"
+      ],
+      "tokenBudgetClass": "core",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": true,
+      "symptomTriggers": [
+        "the user wants to discover YouTube videos by topic or inspect a channel library"
+      ],
+      "samplePrompts": [
+        "Find YouTube videos about local SEO",
+        "Harvest videos from @mkbhd",
+        "Show the top videos for this query"
+      ],
+      "formatExamples": [
+        "mode=\"search\", query=\"best SEO tutorials 2026\"",
+        "mode=\"channel\", channelHandle=\"@mkbhd\""
+      ],
+      "negativeSpace": "Use youtube_transcribe after selecting one video ID or URL.",
+      "producesHandlesFor": [
+        "youtube_transcribe"
+      ],
+      "consumesHandles": []
+    },
+    {
+      "name": "youtube_transcribe",
+      "surfaces": [
+        "main_stdio",
+        "combined_stdio",
+        "hosted_http"
+      ],
+      "tokenBudgetClass": "core",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": true,
+      "symptomTriggers": [
+        "the user asks what a YouTube video says, wants a transcript, or wants claims/lessons extracted from a video"
+      ],
+      "samplePrompts": [
+        "Transcribe this YouTube URL",
+        "What claims does this video make?",
+        "Summarize the transcript for this video ID"
+      ],
+      "formatExamples": [
+        "videoId=\"dQw4w9WgXcQ\"",
+        "url=\"https://www.youtube.com/watch?v=dQw4w9WgXcQ\""
+      ],
+      "negativeSpace": "Use youtube_harvest first when the user has a topic/channel but no selected video.",
+      "producesHandlesFor": [],
+      "consumesHandles": [
+        "youtube-video-id",
+        "youtube-url"
+      ]
+    },
+    {
+      "name": "facebook_page_intel",
+      "surfaces": [
+        "main_stdio",
+        "combined_stdio",
+        "hosted_http"
+      ],
+      "tokenBudgetClass": "core",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": true,
+      "symptomTriggers": [
+        "the user wants Facebook advertiser ads, ad copy, creatives, landing URLs, or video URLs"
+      ],
+      "samplePrompts": [
+        "Get Facebook ads for this brand",
+        "Find active ads from this advertiser",
+        "Show ad copy and video URLs for this page"
+      ],
+      "formatExamples": [
+        "libraryId=\"765371849553336\"",
+        "country=\"US\"",
+        "maxAds=50"
+      ],
+      "negativeSpace": "Use facebook_ad_search when the advertiser/page is unknown; use facebook_ad_transcribe only after this returns a direct videoUrl.",
+      "producesHandlesFor": [
+        "facebook_ad_transcribe"
+      ],
+      "consumesHandles": [
+        "facebook-page-id",
+        "facebook-library-id",
+        "brand-query"
+      ]
+    },
+    {
+      "name": "facebook_ad_search",
+      "surfaces": [
+        "main_stdio",
+        "combined_stdio",
+        "hosted_http"
+      ],
+      "tokenBudgetClass": "core",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": true,
+      "symptomTriggers": [
+        "the user wants to find advertisers or Facebook Ad Library IDs by brand, keyword, niche, or competitor"
+      ],
+      "samplePrompts": [
+        "Search Facebook ads for Nike",
+        "Find advertisers in the med spa niche",
+        "Which competitors are running ads?"
+      ],
+      "formatExamples": [
+        "query=\"Acme Co\"",
+        "country=\"US\"",
+        "maxResults=10"
+      ],
+      "negativeSpace": "Use facebook_page_intel after this returns a page or library ID.",
+      "producesHandlesFor": [
+        "facebook_page_intel"
+      ],
+      "consumesHandles": []
+    },
+    {
+      "name": "facebook_ad_transcribe",
+      "surfaces": [
+        "main_stdio",
+        "combined_stdio",
+        "hosted_http"
+      ],
+      "tokenBudgetClass": "specialized",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": false,
+      "symptomTriggers": [
+        "the user wants the words or claims from a Facebook Ad Library video creative"
+      ],
+      "samplePrompts": [
+        "Transcribe this Facebook ad videoUrl",
+        "What does this ad say?",
+        "Extract the offer from this ad transcript"
+      ],
+      "formatExamples": [
+        "videoUrl=\"https://video.xx.fbcdn.net/.../creative.mp4\""
+      ],
+      "negativeSpace": "Use facebook_page_intel first if you only have an advertiser; use facebook_video_transcribe for public Facebook post/reel/share URLs.",
+      "producesHandlesFor": [],
+      "consumesHandles": [
+        "facebook-ad-video-url"
+      ]
+    },
+    {
+      "name": "facebook_video_transcribe",
+      "surfaces": [
+        "main_stdio",
+        "combined_stdio",
+        "hosted_http"
+      ],
+      "tokenBudgetClass": "specialized",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": true,
+      "symptomTriggers": [
+        "the user pasted a normal Facebook reel, video, watch, post, share, or fb.watch URL and wants a transcript"
+      ],
+      "samplePrompts": [
+        "Transcribe this Facebook reel",
+        "What is said in this fb.watch video?",
+        "Extract lessons from this Facebook video"
+      ],
+      "formatExamples": [
+        "url=\"https://www.facebook.com/reel/1309788337837052\"",
+        "quality=\"best\""
+      ],
+      "negativeSpace": "Use facebook_ad_transcribe only for direct Ad Library videoUrl values returned by facebook_page_intel.",
+      "producesHandlesFor": [
+        "facebook-mp4-url"
+      ],
+      "consumesHandles": [
+        "facebook-public-video-url"
+      ]
+    },
+    {
+      "name": "maps_place_intel",
+      "surfaces": [
+        "main_stdio",
+        "combined_stdio",
+        "hosted_http"
+      ],
+      "tokenBudgetClass": "core",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": true,
+      "symptomTriggers": [
+        "the user wants detailed Google Maps intelligence for one known business profile"
+      ],
+      "samplePrompts": [
+        "Get reviews for Elite Roofing Denver",
+        "Inspect this Google Business Profile",
+        "Find the phone, hours, and review topics for this business"
+      ],
+      "formatExamples": [
+        "businessName=\"Elite Roofing\", location=\"Denver, CO\"",
+        "includeReviews=true, maxReviews=50"
+      ],
+      "negativeSpace": "Use maps_search first for category searches, prospect lists, or multiple profiles.",
+      "producesHandlesFor": [],
+      "consumesHandles": [
+        "business-name",
+        "maps-place-url"
+      ]
+    },
+    {
+      "name": "maps_search",
+      "surfaces": [
+        "main_stdio",
+        "combined_stdio",
+        "hosted_http"
+      ],
+      "tokenBudgetClass": "core",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": true,
+      "symptomTriggers": [
+        "the user asks for multiple Google Maps businesses, GBPs, GMBs, leads, prospects, or local competitors"
+      ],
+      "samplePrompts": [
+        "Find roofers in Denver CO",
+        "Give me 50 med spas in Nashville",
+        "Search Google Maps for local competitors"
+      ],
+      "formatExamples": [
+        "query=\"roofers\", location=\"Denver, CO\"",
+        "maxResults=10 default, maxResults=50 maximum"
+      ],
+      "negativeSpace": "Use maps_place_intel after selecting one business that needs full profile details or reviews.",
+      "producesHandlesFor": [
+        "maps_place_intel",
+        "directory_workflow"
+      ],
+      "consumesHandles": []
+    },
+    {
+      "name": "directory_workflow",
+      "surfaces": [
+        "main_stdio",
+        "combined_stdio",
+        "hosted_http"
+      ],
+      "tokenBudgetClass": "core",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": true,
+      "symptomTriggers": [
+        "the user wants a directory/prospecting dataset across many US city markets"
+      ],
+      "samplePrompts": [
+        "Build a directory of roofers in Tennessee cities over 100k",
+        "Find dentists across Florida markets",
+        "Create a CSV of local businesses by city"
+      ],
+      "formatExamples": [
+        "query=\"roofers\", state=\"TN\", minPopulation=100000",
+        "concurrency=5, maxResultsPerCity=50"
+      ],
+      "negativeSpace": "Use maps_search for one city/category; use maps_place_intel for one selected profile.",
+      "producesHandlesFor": [
+        "local-csv",
+        "maps_place_intel"
+      ],
+      "consumesHandles": []
+    },
+    {
+      "name": "workflow_list",
+      "surfaces": [
+        "main_stdio",
+        "combined_stdio",
+        "hosted_http"
+      ],
+      "tokenBudgetClass": "specialized",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": false,
+      "symptomTriggers": [
+        "the user asks what higher-level MCP Scraper workflows or recipes are available"
+      ],
+      "samplePrompts": [
+        "What workflows can MCP Scraper run?",
+        "Show local SEO workflows",
+        "What can this MCP do beyond single tools?"
+      ],
+      "formatExamples": [
+        "includeRecipes=true"
+      ],
+      "negativeSpace": "Use workflow_suggest when the user has a concrete goal and needs routing.",
+      "producesHandlesFor": [
+        "workflow_run"
+      ],
+      "consumesHandles": []
+    },
+    {
+      "name": "workflow_suggest",
+      "surfaces": [
+        "main_stdio",
+        "combined_stdio",
+        "hosted_http"
+      ],
+      "tokenBudgetClass": "specialized",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": false,
+      "symptomTriggers": [
+        "the user gives a high-level business/research goal and needs the right workflow or tool chain"
+      ],
+      "samplePrompts": [
+        "Suggest a workflow for market analysis",
+        "How should I research this ICP?",
+        "Route this local SEO audit request"
+      ],
+      "formatExamples": [
+        "goal=\"market analysis for roofers in Tennessee\"",
+        "maxSuggestions=3"
+      ],
+      "negativeSpace": "Use workflow_list when the user only asks what exists; use workflow_run after choosing a workflow.",
+      "producesHandlesFor": [
+        "workflow_run"
+      ],
+      "consumesHandles": []
+    },
+    {
+      "name": "workflow_run",
+      "surfaces": [
+        "main_stdio",
+        "combined_stdio",
+        "hosted_http"
+      ],
+      "tokenBudgetClass": "core",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": true,
+      "symptomTriggers": [
+        "the user wants to start a higher-level workflow such as market analysis, agent packet, audit, or comparison"
+      ],
+      "samplePrompts": [
+        "Run the local competitive audit workflow",
+        "Start an agent packet for this keyword",
+        "Run a SERP comparison workflow"
+      ],
+      "formatExamples": [
+        "workflowId=\"directory\"",
+        "input={\"query\":\"roofers\",\"state\":\"TN\"}"
+      ],
+      "negativeSpace": "Use workflow_suggest or workflow_list first when the workflow ID is unknown; use workflow_step only after this returns a runId.",
+      "producesHandlesFor": [
+        "workflow_step",
+        "workflow_status",
+        "workflow_artifact_read"
+      ],
+      "consumesHandles": [
+        "workflow-id"
+      ]
+    },
+    {
+      "name": "workflow_step",
+      "surfaces": [
+        "main_stdio",
+        "combined_stdio",
+        "hosted_http"
+      ],
+      "tokenBudgetClass": "core",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": true,
+      "symptomTriggers": [
+        "a stepwise workflow has a nextStep and needs to advance one leg without timing out"
+      ],
+      "samplePrompts": [
+        "Continue this workflow run",
+        "Run the next step",
+        "Advance run wrk_123"
+      ],
+      "formatExamples": [
+        "runId=\"wrk_123\" from workflow_run; do not construct it"
+      ],
+      "negativeSpace": "Use workflow_status to inspect a run without advancing it; use workflow_artifact_read to read completed artifacts.",
+      "producesHandlesFor": [
+        "workflow_step",
+        "workflow_artifact_read"
+      ],
+      "consumesHandles": [
+        "workflow-run-id"
+      ]
+    },
+    {
+      "name": "workflow_status",
+      "surfaces": [
+        "main_stdio",
+        "combined_stdio",
+        "hosted_http"
+      ],
+      "tokenBudgetClass": "specialized",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": false,
+      "symptomTriggers": [
+        "the user needs to recover, inspect, or poll an existing workflow run"
+      ],
+      "samplePrompts": [
+        "Check this workflow run status",
+        "List artifacts for run wrk_123",
+        "Did the workflow finish?"
+      ],
+      "formatExamples": [
+        "runId=\"wrk_123\" from workflow_run/workflow_step"
+      ],
+      "negativeSpace": "Use workflow_step to advance a stepwise run; use workflow_artifact_read to read one artifact.",
+      "producesHandlesFor": [
+        "workflow_artifact_read"
+      ],
+      "consumesHandles": [
+        "workflow-run-id"
+      ]
+    },
+    {
+      "name": "workflow_artifact_read",
+      "surfaces": [
+        "main_stdio",
+        "combined_stdio",
+        "hosted_http"
+      ],
+      "tokenBudgetClass": "specialized",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": false,
+      "symptomTriggers": [
+        "the user or model needs to read generated workflow evidence, CSV, JSON, Markdown, report, or task files"
+      ],
+      "samplePrompts": [
+        "Read the evidence artifact",
+        "Open this workflow CSV",
+        "Load the generated Markdown brief"
+      ],
+      "formatExamples": [
+        "runId=\"wrk_123\", artifactId=\"evidence.json\"",
+        "maxBytes=200000"
+      ],
+      "negativeSpace": "Use workflow_status first when artifact IDs are unknown.",
+      "producesHandlesFor": [],
+      "consumesHandles": [
+        "workflow-run-id",
+        "workflow-artifact-id"
+      ]
+    },
+    {
+      "name": "rank_tracker_blueprint",
+      "surfaces": [
+        "main_stdio",
+        "combined_stdio",
+        "hosted_http"
+      ],
+      "tokenBudgetClass": "specialized",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": false,
+      "symptomTriggers": [
+        "the user wants a build-ready plan for rank tracking, cron, database schema, metrics, and implementation prompt"
+      ],
+      "samplePrompts": [
+        "Design a rank tracker for this business",
+        "Create a Maps and organic rank tracker blueprint",
+        "Generate a database plan for AI Overview tracking"
+      ],
+      "formatExamples": [
+        "trackingModes=[\"maps\",\"organic\",\"ai_overview\",\"paa\"]",
+        "timezone=\"America/Denver\""
+      ],
+      "negativeSpace": "Use search_serp, maps_search, or harvest_paa for live rank evidence; this only plans the tracker.",
+      "producesHandlesFor": [],
+      "consumesHandles": []
+    },
+    {
+      "name": "credits_info",
+      "surfaces": [
+        "main_stdio",
+        "combined_stdio",
+        "hosted_http"
+      ],
+      "tokenBudgetClass": "core",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": false,
+      "symptomTriggers": [
+        "the user asks about credits, tool costs, usage limits, concurrency, top-up, or billing commands"
+      ],
+      "samplePrompts": [
+        "How many credits do I have?",
+        "What does maps_search cost?",
+        "How do I add concurrency?"
+      ],
+      "formatExamples": [
+        "item=\"maps reviews\"",
+        "includeLedger=false"
+      ],
+      "negativeSpace": "Use this before large harvests/workflows when credit availability matters; it never exposes card details.",
+      "producesHandlesFor": [],
+      "consumesHandles": []
+    },
+    {
+      "name": "browser_open",
+      "surfaces": [
+        "browser_agent_stdio",
+        "combined_stdio"
+      ],
+      "tokenBudgetClass": "core",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": false,
+      "symptomTriggers": [
+        "the user wants a controllable browser session, live website inspection, login-state browsing, or a human watch URL"
+      ],
+      "samplePrompts": [
+        "Open a browser to this URL",
+        "Start a browser I can watch",
+        "Use a browser session for Facebook"
+      ],
+      "formatExamples": [
+        "url=\"https://example.com\"",
+        "timeout_seconds=600"
+      ],
+      "negativeSpace": "Use browser_list_sessions to recover an existing session; call browser_close when done.",
+      "producesHandlesFor": [
+        "browser_screenshot",
+        "browser_read",
+        "browser_close"
+      ],
+      "consumesHandles": []
+    },
+    {
+      "name": "browser_profile_list",
+      "surfaces": [
+        "browser_agent_stdio",
+        "combined_stdio"
+      ],
+      "tokenBudgetClass": "specialized",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": false,
+      "symptomTriggers": [
+        "the user wants to find which local Chrome account/profile should map to browser-agent sessions"
+      ],
+      "samplePrompts": [
+        "Find my Chrome profile for seo@example.com",
+        "List local Chrome profiles",
+        "What browser profile should I use?"
+      ],
+      "formatExamples": [
+        "email=\"seo@example.com\"",
+        "user_data_dir optional for nonstandard Chrome roots"
+      ],
+      "negativeSpace": "This reads Chrome profile metadata only; it does not import cookies or browser state. Use browser_profile_import to clone local state for local browser mode.",
+      "producesHandlesFor": [
+        "browser_profile_import",
+        "browser_profile_onboard"
+      ],
+      "consumesHandles": []
+    },
+    {
+      "name": "browser_profile_import",
+      "surfaces": [
+        "browser_agent_stdio",
+        "combined_stdio"
+      ],
+      "tokenBudgetClass": "specialized",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": true,
+      "symptomTriggers": [
+        "the user wants MCP Scraper browser sessions to use their real local Chrome login state, cookies, history, or saved site sessions"
+      ],
+      "samplePrompts": [
+        "Import my Chrome profile for local browser mode",
+        "Make browser_open use my logged-in Chrome profile",
+        "Clone seo@example.com into MCP Scraper"
+      ],
+      "formatExamples": [
+        "email=\"seo@example.com\"",
+        "name=\"seo-example-com\"",
+        "overwrite=true to refresh an existing clone"
+      ],
+      "negativeSpace": "This creates a local managed clone only; it does not upload the profile or create a hosted Kernel profile. Use browser_profile_sync to refresh an existing clone.",
+      "producesHandlesFor": [
+        "browser_open"
+      ],
+      "consumesHandles": []
+    },
+    {
+      "name": "browser_profile_sync",
+      "surfaces": [
+        "browser_agent_stdio",
+        "combined_stdio"
+      ],
+      "tokenBudgetClass": "specialized",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": true,
+      "symptomTriggers": [
+        "the user has already imported a Chrome profile and wants to refresh the managed clone from normal Chrome"
+      ],
+      "samplePrompts": [
+        "Sync my imported browser profile",
+        "Refresh local Chrome profile clone",
+        "Update my MCP browser profile after logging into Claude"
+      ],
+      "formatExamples": [
+        "name=\"seo-example-com\""
+      ],
+      "negativeSpace": "Use browser_profile_import first if no managed profile exists. Sync overwrites the managed clone from its recorded source profile.",
+      "producesHandlesFor": [
+        "browser_open"
+      ],
+      "consumesHandles": []
+    },
+    {
+      "name": "browser_profile_onboard",
+      "surfaces": [
+        "browser_agent_stdio",
+        "combined_stdio"
+      ],
+      "tokenBudgetClass": "specialized",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": false,
+      "symptomTriggers": [
+        "the user wants to set up an authenticated hosted browser profile for future hosted browser-agent sessions"
+      ],
+      "samplePrompts": [
+        "Onboard a hosted browser profile",
+        "Set up seo@example.com for hosted browser sessions",
+        "Create a logged-in hosted browser profile"
+      ],
+      "formatExamples": [
+        "email=\"seo@example.com\"",
+        "profile=\"seo-example-com\"",
+        "call browser_close after the human logs in"
+      ],
+      "negativeSpace": "Hosted browser sessions cannot mount local Chrome profile folders; use browser_profile_import for local Chrome state.",
+      "producesHandlesFor": [
+        "browser_close",
+        "browser_screenshot",
+        "browser_open"
+      ],
+      "consumesHandles": []
+    },
+    {
+      "name": "browser_screenshot",
+      "surfaces": [
+        "browser_agent_stdio",
+        "combined_stdio"
+      ],
+      "tokenBudgetClass": "core",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": false,
+      "symptomTriggers": [
+        "the model needs visual perception, coordinates, visible page state, CAPTCHA status, or element positions"
+      ],
+      "samplePrompts": [
+        "Show me what the browser sees",
+        "Take a screenshot of the current page",
+        "Find the coordinates of the login button"
+      ],
+      "formatExamples": [
+        "session_id from browser_open; do not construct it"
+      ],
+      "negativeSpace": "Use browser_read when DOM text is enough; use browser_locate for exact DOM bounds.",
+      "producesHandlesFor": [
+        "browser_click",
+        "browser_replay_mark"
+      ],
+      "consumesHandles": [
+        "browser-session-id"
+      ]
+    },
+    {
+      "name": "browser_read",
+      "surfaces": [
+        "browser_agent_stdio",
+        "combined_stdio"
+      ],
+      "tokenBudgetClass": "core",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": false,
+      "symptomTriggers": [
+        "the model needs current page text, links, forms, or interactive elements without an image"
+      ],
+      "samplePrompts": [
+        "Read the current page",
+        "Get visible text and buttons",
+        "Find the form fields on this page"
+      ],
+      "formatExamples": [
+        "session_id from browser_open"
+      ],
+      "negativeSpace": "Use browser_screenshot when visual layout matters; use browser_locate for exact bounding boxes.",
+      "producesHandlesFor": [
+        "browser_click",
+        "browser_type"
+      ],
+      "consumesHandles": [
+        "browser-session-id"
+      ]
+    },
+    {
+      "name": "browser_locate",
+      "surfaces": [
+        "browser_agent_stdio",
+        "combined_stdio"
+      ],
+      "tokenBudgetClass": "specialized",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": false,
+      "symptomTriggers": [
+        "the model needs exact DOM bounds for a selector or visible text before clicking or annotating"
+      ],
+      "samplePrompts": [
+        "Locate the pricing button",
+        "Find bounds for h1",
+        "Mark the text that says Submit"
+      ],
+      "formatExamples": [
+        "targets=[{\"selector\":\"h1\"}]",
+        "targets=[{\"text\":\"Submit\",\"match\":\"exact\"}]"
+      ],
+      "negativeSpace": "Use browser_screenshot first if you do not know what is visible.",
+      "producesHandlesFor": [
+        "browser_click",
+        "browser_replay_mark"
+      ],
+      "consumesHandles": [
+        "browser-session-id"
+      ]
+    },
+    {
+      "name": "browser_goto",
+      "surfaces": [
+        "browser_agent_stdio",
+        "combined_stdio"
+      ],
+      "tokenBudgetClass": "core",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": false,
+      "symptomTriggers": [
+        "the browser must navigate to a new URL inside an existing session"
+      ],
+      "samplePrompts": [
+        "Go to this URL",
+        "Navigate the browser to Facebook",
+        "Open the competitor page in this session"
+      ],
+      "formatExamples": [
+        "url=\"https://example.com/path\""
+      ],
+      "negativeSpace": "Use browser_open if no session exists; call browser_screenshot after navigation to inspect the result.",
+      "producesHandlesFor": [
+        "browser_screenshot",
+        "browser_read"
+      ],
+      "consumesHandles": [
+        "browser-session-id"
+      ]
+    },
+    {
+      "name": "browser_click",
+      "surfaces": [
+        "browser_agent_stdio",
+        "combined_stdio"
+      ],
+      "tokenBudgetClass": "core",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": false,
+      "symptomTriggers": [
+        "the browser needs to activate a visible UI target using coordinates from a recent perception result"
+      ],
+      "samplePrompts": [
+        "Click the login button",
+        "Click the first result",
+        "Open that menu"
+      ],
+      "formatExamples": [
+        "x=420, y=318 from browser_screenshot/browser_read"
+      ],
+      "negativeSpace": "Use browser_screenshot, browser_read, or browser_locate first when coordinates are unknown; do not guess coordinates.",
+      "producesHandlesFor": [
+        "browser_screenshot",
+        "browser_read"
+      ],
+      "consumesHandles": [
+        "browser-session-id",
+        "browser-coordinate"
+      ]
+    },
+    {
+      "name": "browser_type",
+      "surfaces": [
+        "browser_agent_stdio",
+        "combined_stdio"
+      ],
+      "tokenBudgetClass": "core",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": false,
+      "symptomTriggers": [
+        "the browser needs text entered into the currently focused field"
+      ],
+      "samplePrompts": [
+        "Type this search query",
+        "Fill the email field",
+        "Enter the page URL into the form"
+      ],
+      "formatExamples": [
+        "text=\"best roofers Denver\"",
+        "delay=25"
+      ],
+      "negativeSpace": "Use browser_click or browser_press Tab first if the target field is not focused.",
+      "producesHandlesFor": [
+        "browser_press",
+        "browser_screenshot"
+      ],
+      "consumesHandles": [
+        "browser-session-id"
+      ]
+    },
+    {
+      "name": "browser_scroll",
+      "surfaces": [
+        "browser_agent_stdio",
+        "combined_stdio"
+      ],
+      "tokenBudgetClass": "core",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": false,
+      "symptomTriggers": [
+        "the browser needs to reveal more page content before reading, clicking, or locating"
+      ],
+      "samplePrompts": [
+        "Scroll down",
+        "Scroll to reveal more results",
+        "Move back up the page"
+      ],
+      "formatExamples": [
+        "delta_y=5 scrolls down",
+        "delta_y=-5 scrolls up"
+      ],
+      "negativeSpace": "Use browser_screenshot after scrolling to inspect newly visible content.",
+      "producesHandlesFor": [
+        "browser_screenshot",
+        "browser_read"
+      ],
+      "consumesHandles": [
+        "browser-session-id"
+      ]
+    },
+    {
+      "name": "browser_press",
+      "surfaces": [
+        "browser_agent_stdio",
+        "combined_stdio"
+      ],
+      "tokenBudgetClass": "core",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": false,
+      "symptomTriggers": [
+        "the browser needs keyboard input such as submit, escape, tab, select-all, or navigation keys"
+      ],
+      "samplePrompts": [
+        "Press Enter",
+        "Press Escape",
+        "Select all and replace the field text"
+      ],
+      "formatExamples": [
+        "keys=[\"Return\"]",
+        "keys=[\"Ctrl+a\"]",
+        "keys=[\"Ctrl+Shift+Tab\"]"
+      ],
+      "negativeSpace": "Use browser_type for text entry; call browser_screenshot after keypresses that may change the page.",
+      "producesHandlesFor": [
+        "browser_screenshot",
+        "browser_read"
+      ],
+      "consumesHandles": [
+        "browser-session-id"
+      ]
+    },
+    {
+      "name": "browser_replay_start",
+      "surfaces": [
+        "browser_agent_stdio",
+        "combined_stdio"
+      ],
+      "tokenBudgetClass": "specialized",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": false,
+      "symptomTriggers": [
+        "the user wants an MP4 proof replay of browser work or later annotations"
+      ],
+      "samplePrompts": [
+        "Start recording this browser session",
+        "Record proof while I click through checkout",
+        "Begin replay capture"
+      ],
+      "formatExamples": [
+        "session_id from browser_open"
+      ],
+      "negativeSpace": "Use browser_replay_stop to finish the recording; use browser_replay_mark while recording for accurate callouts.",
+      "producesHandlesFor": [
+        "browser_replay_stop",
+        "browser_replay_mark",
+        "browser_replay_download"
+      ],
+      "consumesHandles": [
+        "browser-session-id"
+      ]
+    },
+    {
+      "name": "browser_replay_stop",
+      "surfaces": [
+        "browser_agent_stdio",
+        "combined_stdio"
+      ],
+      "tokenBudgetClass": "specialized",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": false,
+      "symptomTriggers": [
+        "an active replay recording needs to be finalized"
+      ],
+      "samplePrompts": [
+        "Stop recording",
+        "Finish the replay",
+        "End this proof video"
+      ],
+      "formatExamples": [
+        "replay_id returned by browser_replay_start; do not construct it"
+      ],
+      "negativeSpace": "Use browser_replay_download to save the MP4 locally; use browser_replay_annotate to create an annotated copy.",
+      "producesHandlesFor": [
+        "browser_replay_download",
+        "browser_replay_annotate"
+      ],
+      "consumesHandles": [
+        "browser-session-id",
+        "browser-replay-id"
+      ]
+    },
+    {
+      "name": "browser_list_replays",
+      "surfaces": [
+        "browser_agent_stdio",
+        "combined_stdio"
+      ],
+      "tokenBudgetClass": "specialized",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": false,
+      "symptomTriggers": [
+        "the model needs to recover replay IDs, view URLs, or download URLs for a browser session"
+      ],
+      "samplePrompts": [
+        "List replays for this session",
+        "Find the replay ID",
+        "Show recorded videos"
+      ],
+      "formatExamples": [
+        "session_id from browser_open"
+      ],
+      "negativeSpace": "Use browser_replay_start to create a new replay; use browser_replay_download to save one locally.",
+      "producesHandlesFor": [
+        "browser_replay_download",
+        "browser_replay_annotate"
+      ],
+      "consumesHandles": [
+        "browser-session-id"
+      ]
+    },
+    {
+      "name": "browser_replay_download",
+      "surfaces": [
+        "browser_agent_stdio",
+        "combined_stdio"
+      ],
+      "tokenBudgetClass": "specialized",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": true,
+      "symptomTriggers": [
+        "the user wants a replay MP4 saved locally"
+      ],
+      "samplePrompts": [
+        "Download this replay",
+        "Save the MP4 proof video",
+        "Put the replay in the output folder"
+      ],
+      "formatExamples": [
+        "filename=\"proof\"",
+        "replay_id from browser_replay_start/browser_list_replays"
+      ],
+      "negativeSpace": "Use browser_replay_stop first if the replay is still recording; use browser_replay_annotate for a marked-up video.",
+      "producesHandlesFor": [
+        "local-mp4-path"
+      ],
+      "consumesHandles": [
+        "browser-session-id",
+        "browser-replay-id"
+      ]
+    },
+    {
+      "name": "browser_replay_mark",
+      "surfaces": [
+        "browser_agent_stdio",
+        "combined_stdio"
+      ],
+      "tokenBudgetClass": "specialized",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": false,
+      "symptomTriggers": [
+        "the user wants accurate replay callout coordinates and timing for a visible DOM target"
+      ],
+      "samplePrompts": [
+        "Mark the headline in the replay",
+        "Create a callout for this button",
+        "Get annotation bounds for the pricing text"
+      ],
+      "formatExamples": [
+        "target={\"selector\":\"h1\"}",
+        "duration_seconds=4"
+      ],
+      "negativeSpace": "Use browser_locate for bounds when no replay is recording; use browser_replay_annotate after collecting marks.",
+      "producesHandlesFor": [
+        "browser_replay_annotate"
+      ],
+      "consumesHandles": [
+        "browser-session-id"
+      ]
+    },
+    {
+      "name": "browser_replay_annotate",
+      "surfaces": [
+        "browser_agent_stdio",
+        "combined_stdio"
+      ],
+      "tokenBudgetClass": "specialized",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": true,
+      "symptomTriggers": [
+        "the user wants a replay MP4 with boxes, circles, arrows, underlines, or labels rendered into it"
+      ],
+      "samplePrompts": [
+        "Annotate the replay with these callouts",
+        "Add boxes around the key UI elements",
+        "Create a marked-up proof video"
+      ],
+      "formatExamples": [
+        "annotations=[{\"type\":\"box\",\"start_seconds\":1,\"left\":100,\"top\":80,\"width\":400,\"height\":120}]"
+      ],
+      "negativeSpace": "Use browser_replay_mark while recording for accurate annotations; use browser_replay_download for an unannotated MP4.",
+      "producesHandlesFor": [
+        "local-annotated-mp4-path"
+      ],
+      "consumesHandles": [
+        "browser-session-id",
+        "browser-replay-id"
+      ]
+    },
+    {
+      "name": "browser_close",
+      "surfaces": [
+        "browser_agent_stdio",
+        "combined_stdio"
+      ],
+      "tokenBudgetClass": "core",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": false,
+      "symptomTriggers": [
+        "the browser task is done and active billing should stop"
+      ],
+      "samplePrompts": [
+        "Close the browser session",
+        "Stop the browser meter",
+        "Release this session"
+      ],
+      "formatExamples": [
+        "session_id from browser_open"
+      ],
+      "negativeSpace": "Use browser_list_sessions if the active session ID is unknown.",
+      "producesHandlesFor": [],
+      "consumesHandles": [
+        "browser-session-id"
+      ]
+    },
+    {
+      "name": "browser_list_sessions",
+      "surfaces": [
+        "browser_agent_stdio",
+        "combined_stdio"
+      ],
+      "tokenBudgetClass": "core",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": false,
+      "symptomTriggers": [
+        "the model needs to recover active browser session IDs or watch URLs"
+      ],
+      "samplePrompts": [
+        "List my browser sessions",
+        "Find the active browser",
+        "Show open browser sessions"
+      ],
+      "formatExamples": [
+        "include_closed=false by default"
+      ],
+      "negativeSpace": "Use browser_open to create a new session; use browser_close after choosing a session to close.",
+      "producesHandlesFor": [
+        "browser_open",
+        "browser_close",
+        "browser_screenshot"
+      ],
+      "consumesHandles": []
+    },
+    {
+      "name": "capture_serp_snapshot",
+      "surfaces": [
+        "hosted_http",
+        "hosted_only"
+      ],
+      "tokenBudgetClass": "hosted_only",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": false,
+      "symptomTriggers": [
+        "the user needs hosted SERP Intelligence evidence through the product capture path"
+      ],
+      "samplePrompts": [
+        "Capture a SERP Intelligence snapshot for this keyword",
+        "Record hosted SERP evidence for Denver HVAC",
+        "Capture Google results with debug evidence"
+      ],
+      "formatExamples": [
+        "query=\"best hvac company\", location=\"Denver, CO\"",
+        "includePageSnapshots=true, pageSnapshotLimit=3"
+      ],
+      "negativeSpace": "Use search_serp for quick MCP SERP lookup; use capture_serp_page_snapshots for page-only evidence.",
+      "producesHandlesFor": [
+        "capture_serp_page_snapshots"
+      ],
+      "consumesHandles": []
+    },
+    {
+      "name": "capture_serp_page_snapshots",
+      "surfaces": [
+        "hosted_http",
+        "hosted_only"
+      ],
+      "tokenBudgetClass": "hosted_only",
+      "hasOutputSchema": true,
+      "hasStructuredContent": true,
+      "writesLocalFiles": false,
+      "symptomTriggers": [
+        "the user needs hosted evidence snapshots for ranking pages, AI citations, local pack websites, or configured targets"
+      ],
+      "samplePrompts": [
+        "Capture page snapshots for these ranking URLs",
+        "Snapshot the AI citation pages",
+        "Capture target page evidence for SERP Intelligence"
+      ],
+      "formatExamples": [
+        "urls=[\"https://example.com\"]",
+        "targets=[{\"url\":\"https://example.com\",\"sourceKind\":\"organic\",\"sourcePosition\":1}]"
+      ],
+      "negativeSpace": "Use capture_serp_snapshot when the SERP itself also needs to be captured.",
+      "producesHandlesFor": [],
+      "consumesHandles": [
+        "public-url"
+      ]
+    }
+  ]
+}