mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
Every page now loads /webmcp.js, scripts/webmcp.ts with its types stripped (npm run webmcp). Where the browser has document.modelContext it registers two read-only tools: search_skills over the published skills index, and get_skill, which returns a skill's markdown checked against the index digest. The markdown alternate link moves from build.py to site.py, so CI holds every page to it. The API catalog gains the site itself (llms.txt and the skills index) and hanzo.ai/agents; the live discovery check now fetches every catalog link. tests/site.mjs drives the tools through a recording modelContext, and checks a browser without one loads clean.
304 lines
21 KiB
HTML
304 lines
21 KiB
HTML
<!doctype html>
|
|
<html lang="en"><head>
|
|
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>tool-reference</title>
|
|
<meta name="color-scheme" content="dark">
|
|
<style>
|
|
/* Committed to one visual world: a dark instrument panel. No light variant —
|
|
the dot field and the hairline rules only read on black, and a naive
|
|
inversion would wash both out. Every colour is painted explicitly so the page
|
|
never borrows a host background. */
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
|
|
|
|
:root{
|
|
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
|
|
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
|
|
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
|
|
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
|
|
--font-zen-pixel-square:'Zen Pixel Square',monospace;
|
|
--mono:var(--font-zen-mono);
|
|
--sans:var(--font-zen-sans);
|
|
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
|
|
--r:999px; --r-soft:14px;
|
|
}
|
|
*{box-sizing:border-box}
|
|
html{-webkit-text-size-adjust:100%}
|
|
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
|
|
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
|
|
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
|
|
|
|
/* The dot field. A halftone made of one repeating radial-gradient, faded out
|
|
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
|
|
/* No overflow clip here: the dot field is inset to the box already, and a clip
|
|
would cut off the copy-prompt menu. */
|
|
.hero{position:relative;border-bottom:1px solid var(--line)}
|
|
.hero::before{content:"";position:absolute;inset:0;
|
|
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
|
|
background-size:7px 7px;
|
|
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
pointer-events:none}
|
|
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
|
|
|
|
nav{border-bottom:1px solid var(--line)}
|
|
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
|
|
justify-content:space-between;align-items:center;gap:1rem}
|
|
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--ink);text-decoration:none;
|
|
display:inline-flex;align-items:center;gap:.6rem}
|
|
.brand i{font-style:normal;color:var(--faint)}
|
|
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
|
|
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--soft);text-decoration:none}
|
|
nav a.up:hover{color:var(--ink)}
|
|
|
|
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
|
|
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
|
|
h1 em{font-style:normal;color:var(--faint)}
|
|
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
|
|
|
|
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
|
|
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
|
|
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
|
|
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
|
|
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
|
|
line-height:1.2;font-weight:400}
|
|
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
|
|
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
|
|
.btn.solid:hover{background:#d8d8d4}
|
|
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
|
|
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
|
|
|
|
/* Copy-prompt selector. Each row copies the prompt for its own target. */
|
|
.copy{position:relative;display:inline-flex}
|
|
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
|
|
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
|
|
padding:.4rem;display:flex;flex-direction:column;
|
|
box-shadow:0 12px 32px rgba(0,0,0,.75)}
|
|
.menu[hidden]{display:none}
|
|
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
|
|
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
|
|
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
|
|
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
|
|
white-space:nowrap}
|
|
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
|
|
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
|
|
.mi:hover .mark{color:var(--ink)}
|
|
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
|
|
letter-spacing:.1em;text-transform:uppercase}
|
|
|
|
/* Works-with bar: one scrolling row, name and mark per agent. */
|
|
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
|
|
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
|
|
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
|
|
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
|
|
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
|
|
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
|
|
display:flex;align-items:center}
|
|
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
|
|
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
|
|
-webkit-overflow-scrolling:touch;
|
|
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
|
|
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
|
|
.bar::-webkit-scrollbar{display:none}
|
|
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
|
|
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
|
|
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
|
|
text-decoration:none;background:var(--ground)}
|
|
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
|
|
.agent .mark{width:.95rem;height:.95rem}
|
|
|
|
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
|
|
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
|
|
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
|
|
p{margin:0 0 1rem;max-width:70ch}
|
|
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
|
|
li{margin:.22rem 0}
|
|
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
|
|
text-decoration-color:var(--line-hi)}
|
|
a:hover{text-decoration-color:var(--ink)}
|
|
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
|
|
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
|
|
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
|
|
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
|
|
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
|
|
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
|
|
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
|
|
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
|
|
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
|
|
display:block;overflow-x:auto}
|
|
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
|
|
|
|
.curl{display:block;background:var(--panel);border:1px solid var(--line);
|
|
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
|
|
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
|
|
white-space:pre;line-height:1.9}
|
|
.curl b{color:var(--ink);font-weight:400}
|
|
.curl i{font-style:normal;color:var(--faint)}
|
|
|
|
/* index */
|
|
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
|
|
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
|
|
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
|
|
#q:focus{outline:none;border-color:var(--soft)}
|
|
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
|
|
text-transform:uppercase;margin:0 0 2rem}
|
|
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
|
|
padding-bottom:.45rem}
|
|
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
|
|
border-radius:var(--r-soft);text-decoration:none}
|
|
.row:hover{background:#0a0a0a}
|
|
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
|
|
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
|
|
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
|
|
color:var(--faint);font-size:.85rem}
|
|
footer a{color:var(--soft)}
|
|
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
|
|
margin:0 0 2rem;font-size:.85rem}
|
|
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
|
|
border-bottom:1px solid var(--line);padding-bottom:.4rem}
|
|
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
|
|
.fmap a:hover{text-decoration:underline}
|
|
.fmap div{color:var(--faint);line-height:1.5}
|
|
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
|
|
|
|
@media (max-width:640px){
|
|
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
|
|
.btns{gap:.5rem}
|
|
.btn{padding:.75rem 1.15rem;font-size:.68rem}
|
|
.copy,.copy .btn{width:100%;justify-content:center}
|
|
.menu{left:0;right:0;min-width:0}
|
|
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
|
|
.strip b{border-right:0;padding-right:0}
|
|
.bar{width:100%}
|
|
}
|
|
</style>
|
|
<link rel="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/tool-reference">
|
|
<link rel="alternate" type="text/markdown" href="/tool-reference.md">
|
|
<script type="module" src="/webmcp.js"></script>
|
|
</head>
|
|
<!-- Reading this with a machine? Every page here is also plain markdown.
|
|
This one: https://hanzoskills.com/tool-reference.md
|
|
Index: https://hanzoskills.com/llms.txt
|
|
Corpus: https://hanzoskills.com/all.md
|
|
Append .md to any path for the markdown twin. -->
|
|
<body>
|
|
<nav><div class="in">
|
|
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
|
|
<a class="up" href="/">All skills</a>
|
|
</div></nav>
|
|
|
|
<div class="wrap">
|
|
<h1>tool-reference</h1><p class="lede">Quick reference for the Firecrawl and DataForSEO MCP tools used in competitor profiling.</p><h1>MCP Tool Reference for Competitor Profiling</h1>
|
|
<p>Quick reference for the Firecrawl and DataForSEO MCP tools used in competitor profiling.</p>
|
|
<h2>Contents</h2>
|
|
<ul><li>Firecrawl Tools (site scraping)</li><li>DataForSEO Tools (SEO & market data)</li><li>Recommended Execution Order</li><li>Error Handling</li></ul>
|
|
<hr>
|
|
<h2>Firecrawl Tools</h2>
|
|
<h3>firecrawl_map</h3>
|
|
<p><strong>Purpose</strong>: Discover all URLs on a competitor's site to identify key pages. <strong>When to use</strong>: First step for every competitor — before scraping individual pages. <strong>Key output</strong>: List of URLs with their page types/paths. <strong>Tip</strong>: Look for paths containing <code>/pricing</code>, <code>/features</code>, <code>/about</code>, <code>/customers</code>, <code>/integrations</code>, <code>/blog</code>, <code>/changelog</code>.</p>
|
|
<h3>firecrawl_scrape</h3>
|
|
<p><strong>Purpose</strong>: Extract content from a single page as clean markdown. <strong>When to use</strong>: After mapping, scrape each key page individually. <strong>Key output</strong>: Page content in markdown format — headlines, body text, structured data. <strong>Tip</strong>: Scrape homepage first — it reveals positioning, audience, and social proof in one shot.</p>
|
|
<h3>firecrawl_search</h3>
|
|
<p><strong>Purpose</strong>: Search the web for specific content about a competitor. <strong>When to use</strong>: Finding review pages, press coverage, or competitor mentions not on their own site. <strong>Example queries</strong>:</p>
|
|
<ul><li><code>"[Competitor Name]" site:g2.com</code></li><li><code>"[Competitor Name]" review</code></li><li><code>"[Competitor Name]" funding OR raised</code></li></ul>
|
|
<h3>firecrawl_crawl</h3>
|
|
<p><strong>Purpose</strong>: Crawl multiple pages from a site in one operation. <strong>When to use</strong>: Deep profiles where you want to analyze many pages (e.g., all feature pages, all blog posts). More expensive — use selectively. <strong>Tip</strong>: Set page limits to avoid crawling entire sites. Target specific URL patterns.</p>
|
|
<h3>firecrawl_extract</h3>
|
|
<p><strong>Purpose</strong>: Extract structured data from a page using a schema. <strong>When to use</strong>: When you need specific data points in a consistent format (e.g., pricing tier details, feature lists). <strong>Tip</strong>: Define a clear schema for what you want extracted — more reliable than parsing raw markdown.</p>
|
|
<hr>
|
|
<h2>DataForSEO MCP Tools</h2>
|
|
<h3>Domain-Level Intelligence</h3>
|
|
<h4>backlinks_summary</h4>
|
|
<p><strong>Purpose</strong>: Get domain authority, total backlinks, referring domains, spam score. <strong>Input</strong>: Target domain (e.g., <code>competitor.com</code>) <strong>Key metrics</strong>: <code>domain_rank</code>, <code>total_backlinks</code>, <code>referring_domains</code>, <code>backlinks_spam_score</code></p>
|
|
<h4>backlinks_referring_domains</h4>
|
|
<p><strong>Purpose</strong>: List top referring domains — shows where their link equity comes from. <strong>Input</strong>: Target domain + limit <strong>Key metrics</strong>: Per-domain: <code>rank</code>, <code>backlinks</code>, <code>domain</code> name</p>
|
|
<h4>dataforseo_labs_google_domain_rank_overview</h4>
|
|
<p><strong>Purpose</strong>: Organic search overview — traffic, keywords, traffic value. <strong>Input</strong>: Target domain <strong>Key metrics</strong>: <code>organic_count</code> (keywords), <code>organic_traffic</code> (estimated monthly), <code>organic_cost</code> (traffic value in $)</p>
|
|
<h4>dataforseo_labs_google_ranked_keywords</h4>
|
|
<p><strong>Purpose</strong>: What keywords a domain ranks for, with positions. <strong>Input</strong>: Target domain <strong>Key metrics</strong>: Per-keyword: <code>keyword</code>, <code>position</code>, <code>search_volume</code>, <code>url</code> (ranking page) <strong>Tip</strong>: Sort by traffic to find their highest-value keywords.</p>
|
|
<h4>dataforseo_labs_google_keywords_for_site</h4>
|
|
<p><strong>Purpose</strong>: Keywords relevant to a domain — broader than ranked keywords, includes opportunities. <strong>Input</strong>: Target domain <strong>Key metrics</strong>: <code>keyword</code>, <code>search_volume</code>, <code>competition</code>, <code>cpc</code></p>
|
|
<h3>Competitive Analysis</h3>
|
|
<h4>dataforseo_labs_google_competitors_domain</h4>
|
|
<p><strong>Purpose</strong>: Find a domain's closest organic competitors by keyword overlap. <strong>Input</strong>: Target domain <strong>Key metrics</strong>: <code>domain</code>, <code>avg_position</code>, <code>intersections</code> (shared keywords), <code>full_domain_rank</code> <strong>Tip</strong>: May reveal competitors the user hasn't considered.</p>
|
|
<h4>dataforseo_labs_google_domain_intersection</h4>
|
|
<p><strong>Purpose</strong>: Find keywords where two domains both rank — shows direct competition. <strong>Input</strong>: Two target domains <strong>Key metrics</strong>: <code>keyword</code>, position for each domain, <code>search_volume</code> <strong>Tip</strong>: Use this to compare the user's domain vs. each competitor.</p>
|
|
<h4>dataforseo_labs_google_relevant_pages</h4>
|
|
<p><strong>Purpose</strong>: Find a domain's most important pages by organic traffic. <strong>Input</strong>: Target domain <strong>Key metrics</strong>: <code>page</code>, <code>metrics</code> (traffic, keywords per page) <strong>Tip</strong>: Reveals their content strategy — which pages drive the most value.</p>
|
|
<h3>Technology Detection</h3>
|
|
<h4>domain_analytics_technologies_domain_technologies</h4>
|
|
<p><strong>Purpose</strong>: Detect the technology stack a domain uses. <strong>Input</strong>: Target domain <strong>Key metrics</strong>: Technologies grouped by category (CMS, analytics, marketing, payments, etc.)</p>
|
|
<h3>Backlink Deep Dive</h3>
|
|
<h4>backlinks_backlinks</h4>
|
|
<p><strong>Purpose</strong>: List individual backlinks to a domain. <strong>Input</strong>: Target domain + limit <strong>Key metrics</strong>: <code>url_from</code>, <code>url_to</code>, <code>anchor</code>, <code>domain_from_rank</code>, <code>is_new</code></p>
|
|
<h4>backlinks_bulk_ranks</h4>
|
|
<p><strong>Purpose</strong>: Compare domain ranks across multiple domains at once. <strong>Input</strong>: Array of target domains <strong>Key metrics</strong>: <code>domain_rank</code> per domain <strong>Tip</strong>: Use this for the summary comparison table.</p>
|
|
<hr>
|
|
<h2>Recommended Execution Order</h2>
|
|
<h3>Quick Scan (per competitor)</h3>
|
|
<pre><code>1. firecrawl_map → get site URLs
|
|
2. In parallel:
|
|
a. firecrawl_scrape → homepage
|
|
b. firecrawl_scrape → pricing page
|
|
c. dataforseo_labs_google_domain_rank_overview → organic metrics
|
|
d. backlinks_summary → domain authority
|
|
3. Synthesize into abbreviated profile</code></pre>
|
|
<h3>Deep Profile (per competitor)</h3>
|
|
<pre><code>1. firecrawl_map → get site URLs
|
|
2. In parallel (batch 1 — scraping):
|
|
a. firecrawl_scrape → homepage
|
|
b. firecrawl_scrape → pricing page
|
|
c. firecrawl_scrape → features page(s)
|
|
d. firecrawl_scrape → about page
|
|
e. firecrawl_scrape → customers/case studies page
|
|
f. firecrawl_scrape → integrations page
|
|
3. In parallel (batch 2 — SEO data):
|
|
a. dataforseo_labs_google_domain_rank_overview
|
|
b. dataforseo_labs_google_ranked_keywords
|
|
c. backlinks_summary
|
|
d. backlinks_referring_domains
|
|
e. dataforseo_labs_google_relevant_pages
|
|
f. dataforseo_labs_google_competitors_domain
|
|
4. In parallel (batch 3 — optional extras):
|
|
a. domain_analytics_technologies_domain_technologies
|
|
b. firecrawl_search → G2/Capterra reviews
|
|
c. dataforseo_labs_google_domain_intersection (vs. user's domain)
|
|
5. Synthesize into full profile</code></pre>
|
|
<h3>Multi-Competitor (3+ competitors)</h3>
|
|
<pre><code>1. Map all competitor sites in parallel
|
|
2. Scrape all homepages in parallel, then pricing pages in parallel
|
|
3. Pull domain_rank_overview for all in parallel
|
|
4. Pull backlinks_bulk_ranks for all at once
|
|
5. Build profiles in sequence (synthesis requires focus)
|
|
6. Build summary comparison last</code></pre>
|
|
<hr>
|
|
<h2>Error Handling</h2>
|
|
<p>| Issue | Action | |-------|--------| | Firecrawl scrape returns empty/blocked | Try with <code>firecrawl_browser_create</code> for JS-heavy sites | | Pricing page not found in map | Search for <code>/pricing</code>, <code>/plans</code>, <code>/packages</code> — some sites use different paths | | DataForSEO returns no data for domain | Domain may be too new or too small — note "insufficient data" in profile | | Rate limits hit | Space out requests; prioritize highest-value data first | | Review page scraping blocked | Use <code>firecrawl_search</code> to find cached or alternative review sources |</p>
|
|
<footer>
|
|
<div class="fmap">
|
|
<div><b>Build</b>
|
|
<a href="https://hanzo.app">hanzo.app</a> app builder
|
|
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
|
|
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
|
|
<div><b>Run</b>
|
|
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
|
|
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
|
|
<div><b>Account</b>
|
|
<a href="https://hanzo.id">hanzo.id</a> sign in
|
|
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
|
|
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
|
|
<div><b>Company</b>
|
|
<a href="https://hanzo.ai">hanzo.ai</a> canonical
|
|
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
|
|
</div>
|
|
<div class="fend"><a href="/tool-reference.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
|
</footer>
|
|
</div></body></html> |