HarborRank

Returns a backlinks profile summary (total backlinks, referring domains, top referring domains). On the hosted Free plan it returns a preview instead (totals and the top 3 referring domains); the full overview needs a paid plan. Self-hosted deployments need the Backlinks API enabled on their DataForSEO account.

get_backlinks_overview

Returns one bounded page of detailed backlink rows for a domain or page: linking URLs, target URLs, anchors, dofollow/nofollow, authority/spam signals, and lost/broken status. Supports filters, sorting, one_per_domain/as_is mode, and pagination. On the hosted Free plan it returns a preview instead (totals and the top 3 referring domains); backlink rows need a paid plan. Self-hosted deployments need the Backlinks API enabled on their DataForSEO account.

get_backlinks_profile

Returns the organic keywords a domain ranks for, including position and available metrics. Use after get_domain_overview when you want the detailed keyword opportunity list for a competitor or reference domain. Cached for 12 hours.

get_domain_keyword_suggestions

Returns a high-level view of a domain's organic footprint: estimated organic traffic, organic keyword count, backlinks, and referring domains. Use this first for domain research; for the detailed ranked-keyword list, call get_domain_keyword_suggestions next. Cached for 12 hours per domain.

get_domain_overview

Hydrate up to 700 known keywords with search volume, keyword difficulty (KD), search intent, CPC, competition, and monthly trends in a single call. Use it to score candidate or known keywords — including Search Console striking-distance queries — by real demand and ranking difficulty. For countries served from Google Ads data (e.g. Iceland), KD and intent are null.

get_keyword_metrics

Returns the Markdown teardown research_lead generated for a lead: pack positions from three points, the searches that bring jobs, the top-three profile comparison, website footprint and audit findings, and the fixes.

get_lead_teardown

Fetches one Google Maps or Local Finder SERP near a coordinate. Returns one row per listing (rank, title, domain, URL, category, rating, reviews, phone, address, claimed status, place_id, cid, coordinates); match a target business by place_id, cid, domain or title.

get_local_serp_results

Read-only access to rank tracker configs and their latest results. With `trackerId`, returns config + latest snapshot per keyword. Without it, lists all trackers in the project. To trigger a new check, use the dashboard.

get_rank_tracker

Returns market-specific keyword, rank, search volume, keyword difficulty (KD), CPC, intent, estimated traffic and ranking URL rows for a domain or page. Accepts country-level DataForSEO Labs location/language codes. Use this for strategy evidence; use get_domain_overview for aggregate domain footprint.

get_ranked_keywords

Read the prioritized issue report from a completed site audit. Every issue carries a how_to_fix with concrete remediation steps an agent can act on. Omit auditId for the most recent audit.

get_audit_issues

List crawled pages from a site audit with per-page SEO data (status, title, description, word count, indexability, crawl depth, link counts) and, for pages Lighthouse checked, mobile and desktop scores (performance, accessibility, best practices, SEO) and LCP, CLS, INP and TTFB. Omit auditId for the most recent audit.

get_audit_pages

Check the progress of a site audit (phase, pages crawled, Lighthouse progress). Omit auditId for the most recent audit.

get_audit_status

Run Google Search Console's URL Inspection on up to 10 URLs of the connected property: index/coverage state, last crawl time, Google-selected vs declared canonical, and mobile/rich-results verdicts. Use it to answer 'is this page indexed? why not?'. Per-URL failures are reported inline. Read-only.

inspect_urls

Lists the Google Business category taxonomy used by prospect_leads' `categories` filter, sorted by listing count. Use to find the right category slugs for a niche.

list_business_categories

Lists the project's saved prospecting leads with their track and outreach status.

list_leads

Lists all projects in the user's organization. Use this whenever you need a `projectId` for another HarborRank tool. Returns an array of {id, name, domain, locationCode, languageCode}; pass the `id` value as `projectId`. locationCode/languageCode are the project's default market — tools fall back to them when a call omits location/language args.

list_projects

Lists keywords saved to a project (with cached metrics like search volume, difficulty, CPC, and tags if available). Use tag filters when the user asks for a saved segment; multiple tags match ANY tag.

list_saved_keywords

Lists the reports this workspace has published with create_share_report, newest first, with each link, its view count and its id.

list_share_reports

Searches Google Business listings for a niche and saves new businesses to the project's lead list (deduped by place and domain). Two modes: city (locationCode — a Google Maps search for the niche in that city) or coordinate (latitude/longitude/radiusKm). Stores each listing's coordinates and profile depth (photos, categories, 24h hours) so research_lead can check pack positions around the business. Use list_leads to read the list back.

prospect_leads

Publishes a read-only report page at a private link anyone with the link can open, without signing in: use it when the user wants to send findings to a client, a boss or a teammate. Write the report from research already done in this conversation. Before publishing, show the user the title and confirm they want a shareable link, and leave out anything they haven't agreed to share (their Search Console or Analytics numbers in particular). Returns the link; reports can be listed with list_share_reports and removed with delete_share_report.

create_share_report

Research keyword data (search volume, difficulty, CPC, related ideas) for 1-5 seed keywords in one call. In countries served from Google Ads data, difficulty and intent are unavailable. Returns per-seed results — a single bad seed won't fail the batch.

research_keywords

Runs HarborRank's in-product research on a saved lead and stores the evidence: money keywords with volume, the lead's Google Maps position and who holds #1, the primary keyword checked from three points around the business, the top three competitors with profile depth (photos, categories, 24h hours, Q&A, distance), the lead's organic footprint, contact discovery, an optional AI Overview check, and a quick site audit. Then writes the Markdown teardown that get_lead_teardown returns. On hosted HarborRank this requires a paid plan.

research_lead

Start a site audit with HarborRank's own crawler (no third-party API): crawls the site at the given URL (robots.txt-aware, same-origin), checks every page for SEO issues (broken links, duplicate/missing titles and descriptions, redirect chains, orphan pages, canonical problems, thin content, and more), and optionally runs Lighthouse on a sample of pages. Runs in the background — poll get_audit_status, then read get_audit_issues. If the site blocks our crawler, pages are honestly flagged as blocked rather than misreported.

run_site_audit

Save keywords to a project's saved-keywords list. Idempotent: re-saving an existing keyword is a no-op. If tags are provided, missing tags may be created. By default tags are appended; set tagMode=replace to remove existing tags from these saved keywords before applying the provided tags, which is useful for reorganizing keywords into page/topic clusters. Ask the user for confirmation before applying or replacing tags broadly.

save_keywords

Searches local business listings near a coordinate. Use this to find local business candidates or nearby competitors; it does not run Maps rank checks or Q&A.

search_local_businesses

Stores real search-ranking evidence for a lead's report: per keyword, the search volume, the lead's actual position, and the top-ranking business. Replaces the lead's existing checks.

set_lead_serp_checks

Stores the named competitors shown side-by-side in a lead's report. Replaces the lead's existing competitor list.

set_lead_competitors

Stores a lead's top audit findings in plain English — the raw material for the teaser email and report. Replaces the lead's existing list.

set_lead_top_issues

Updates a saved lead's track, outreach status, owner name, contact email, or notes. Use after audits (status='audited') or when outreach state changes.

update_lead

Returns the authenticated user, organization, server mode, token scopes, plan, and current credit balance, with a warning once 75% of the monthly credits are used. Use this first to confirm connection context before choosing a project or running research tools, and again to confirm a plan change.

whoami