add_rank_tracker_competitors
ChatGPTAdd competitor domains to a rank tracker so every check also records where they rank for the tracker's keywords, next to the tracked site. Their positions fill in from the next check and show in get_rank_tracker and the app. Use it after competitor research to keep watching the domains that matter. Basic compares up to 3 competitors per tracker; Pro and Agency up to 10. Domains already added are kept. Remove competitors in the app.
ask_ai_models
ChatGPTAsk ChatGPT, Claude, Gemini and Perplexity the same question with web search on, and get each answer, whether it mentions a brand, the pages it cites (flagging the brand's own), and the searches it ran. Use it to see what AI assistants tell customers about a topic and who they recommend. Paid plans only.
compare_site_audits
ChatGPTCompare a project's latest completed site audit with the previous audit of the same site: which issues are new, which are still open, and which were fixed, by issue type with sample URLs. An issue counts as fixed only when the latest audit crawled its page again; issues on pages the latest crawl didn't reach are counted as not re-checked. Use it after a round of fixes to show progress, or to catch regressions. Run run_site_audit first if the project has fewer than two completed audits.
create_project
ChatGPTCreate a new project in the user's organization. Provide a name, and optionally a domain and default market (locationCode/languageCode; a languageCode requires a locationCode). Returns the created {id, name, domain, locationCode, languageCode, url}; pass the returned id as projectId to other HarborRank tools. Call list_projects first to avoid creating a duplicate.
create_share_report
ChatGPTPublishes 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.
delete_project
ChatGPTPERMANENTLY deletes a project and everything in it: saved keywords, rank trackers and their history, site audits, leads, brand tracking, and its Search Console connection. Cannot be undone. Only call this after the user has explicitly asked to delete this specific project by name; if they may want the data later, tell them to archive it from the dashboard instead. Pass the project's exact name as confirmName — a mismatch refuses the delete. Returns the deleted {id, name}.
delete_share_report
ChatGPTDeletes a published report: its link stops working for everyone. Confirm with the user first; this can't be undone.
find_serp_competitors
ChatGPTCompares domains competing in Google results for a supplied keyword set in a country-level DataForSEO Labs market. Accepts location/language codes; not radius-based local SEO.
get_ai_brand_tracking
ChatGPTRead the project's tracked AI share of voice over time: the brand, its competitors, and each check's share of voice, oldest first. Set tracking up on the Brand Lookup page; use get_ai_brand_visibility for a one-off look.
get_ai_brand_visibility
ChatGPTHow often ChatGPT and Google's AI answers mention a brand: mentions and AI search volume per platform, share of voice against competitors, the questions that bring the brand up with the sources those answers cite, the pages cited most, and competitors the answers name. Use it to answer 'do AI assistants recommend us?' and to find questions to win. Uses the project's market. Paid plans only.
get_ai_referral_traffic
ChatGPTMeasure real visits the site gets from AI assistants — ChatGPT, Perplexity, Gemini, Copilot, Claude, DeepSeek, Grok and others — from Google Analytics: sessions, engagement, key events (conversions) and revenue per assistant, the share of all traffic AI now drives, and optionally which landing pages they cite. Combines GA4's built-in AI Assistant channel with referrer matching, so it also covers assistants and history the built-in channel misses. Use it to prove AI-search visibility pays off, track its growth with compareTo, and pick pages to optimize for AI answers.
get_analytics_report
ChatGPTQuery the project's connected Google Analytics 4 property: sessions, users, engagement, key events (conversions) and revenue, broken down by channel, source, landing page, page, device, country or date, with optional period-over-period comparison. This is what happens after the click — use it to see which traffic actually converts, explain traffic drops, and back recommendations with business outcomes. Pair with get_search_console_performance for the before-click half, or use get_landing_page_performance to get both joined per page.
get_audit_issues
ChatGPTRead 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_pages
ChatGPTList 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_status
ChatGPTCheck the progress of a site audit (phase, pages crawled, Lighthouse progress). Omit auditId for the most recent audit.
get_backlinks_overview
ChatGPTReturns 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_profile
ChatGPTReturns 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_core_web_vitals
ChatGPTReal-user Core Web Vitals from the Chrome UX Report: the 28-day p75 for LCP, INP, CLS and TTFB with the share of good, needs-improvement and poor visits, plus about 40 weeks of weekly p75 history. Reads the whole site of the project's domain by default, or one page when url is given (any public site works, so it can check a competitor too). Phone data unless formFactor says otherwise. A no_data status means Chrome hasn't collected enough real-user visits for that site or page.
get_domain_keyword_suggestions
ChatGPTReturns 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_overview
ChatGPTReturns 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_ranks
ChatGPTGet the backlink rank (0-100) of up to 1,000 domains in one call. Use it to compare the strength of the sites in a SERP, a competitor list, or a list of directories and link prospects. A null rank means there is no backlink data for the domain yet (usually a new or tiny site). For one domain's full backlink profile, use get_backlinks_overview.
get_google_business_questions
ChatGPTFetches Google Business Profile questions and answers for one business keyword near a coordinate. Run this only when Q&A evidence is needed.
get_keyword_metrics
ChatGPTHydrate 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_landing_page_performance
ChatGPTThe full SEO funnel per page in one call: Google Search Console clicks, impressions and position joined with Google Analytics organic sessions, engagement, key events (conversions) and revenue for each landing page. Answers 'which pages bring customers, not just clicks?', finds pages that rank but don't convert (fix the page) and pages that convert but barely rank (worth pushing), and flags pages earning Google clicks that Analytics never records (broken tracking). Best starting point for SEO prioritization, content audits and client reporting. Works with Analytics alone if Search Console isn't connected.
get_lead_teardown
ChatGPTReturns 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_local_grid
ChatGPTWithout gridId, lists the project's local rank grids. With gridId, returns its latest scans (newest first), each with the grid of Maps positions and its top-3 share and average position, to show change over time. Run new scans with run_local_grid.
get_local_serp_results
ChatGPTFetches 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_rank_history
ChatGPTRead-only position history for a rank tracker's keywords over its latest completed checks (up to 26), newest first, for one device. Each keyword row lists its position per check. A null position (— in text) means the domain was not found in that check's results; checked: false (not checked in text) means that check got no result for the keyword, so it says nothing about the position. Checks that only re-ran some keywords are left out. Use get_rank_tracker first for the trackerId and trackingKeywordId values.
get_rank_tracker
ChatGPTRead-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_ranked_keywords
ChatGPTReturns 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_search_console_performance
ChatGPTQuery the connected Search Console property's Search Analytics: clicks, impressions, CTR, and average position by query/page/country/device/date. First-party data — use it for what already ranks, near-ranking queries, and pages with real demand. ctr is a 0-1 fraction; position is a 1-based average; dates are Pacific Time; the last ~3 days may be incomplete. Read-only.
get_search_console_sitemaps
ChatGPTList the sitemaps submitted in Google Search Console for the project's connected property: when Google last read each one, whether it's still pending, its error and warning counts, and how many URLs it submits. Use it to check that a sitemap is submitted and being read, or to find a sitemap with errors. Read-only: submit or remove sitemaps in Search Console itself.
get_serp_results
ChatGPTFetch live Google organic search results for 1-10 keywords. Use this to inspect who ranks for a query, verify competitors, compare SERPs across keywords, or gather source URLs before content planning. Does not save results to HarborRank. Per-keyword errors don't fail the batch.
inspect_urls
ChatGPTRun 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.
list_business_categories
ChatGPTLists 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_leads
ChatGPTLists the project's saved prospecting leads with their track and outreach status.
list_projects
ChatGPTLists 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_saved_keywords
ChatGPTLists 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_share_reports
ChatGPTLists the reports this workspace has published with create_share_report, newest first, with each link, its view count and its id.
prospect_leads
ChatGPTSearches 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.
research_keywords
ChatGPTResearch 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_lead
ChatGPTRuns 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.
run_local_grid
ChatGPTCheck where a business shows up in Google Maps for one keyword from a square of points around it (3x3, 5x5 or 7x7), the way a local SEO agency shows a client where in town they appear. Returns the grid of positions (north at the top), the share of points in the top 3, and the average position, and saves the scan to the project so it can be compared later. Pass gridId to re-run a saved grid, or the business's name and coordinates (and place_id when known) to create one. Paid plans; 7x7 grids need Pro or Agency. Takes up to a minute for a 7x7 grid.
run_site_audit
ChatGPTStart 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.
save_keywords
ChatGPTSave 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.
search_local_businesses
ChatGPTSearches 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.
set_cluster_target_page
ChatGPTAssign the page a keyword cluster should rank with. A cluster is a saved-keyword tag: save the cluster's keywords with save_keywords under one tag, then call this with that tag and the page (existing or planned). The mapping shows on the tag in Saved Keywords, so the keyword map stays with the project. It replaces the page set before, if any; pass targetUrl null to clear it.
set_lead_competitors
ChatGPTStores the named competitors shown side-by-side in a lead's report. Replaces the lead's existing competitor list.
set_lead_serp_checks
ChatGPTStores 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_top_issues
ChatGPTStores a lead's top audit findings in plain English — the raw material for the teaser email and report. Replaces the lead's existing list.
update_lead
ChatGPTUpdates a saved lead's track, outreach status, owner name, contact email, or notes. Use after audits (status='audited') or when outreach state changes.
whoami
ChatGPTReturns 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.
add_rank_tracker_competitors
Claudeask_ai_models
Claudecompare_site_audits
Claudecreate_project
Claudecreate_share_report
Claudedelete_project
Claudedelete_share_report
Claudefind_serp_competitors
Claudeget_ai_brand_tracking
Claudeget_ai_brand_visibility
Claudeget_ai_referral_traffic
Claudeget_analytics_report
Claudeget_audit_issues
Claudeget_audit_pages
Claudeget_audit_status
Claudeget_backlinks_overview
Claudeget_backlinks_profile
Claudeget_core_web_vitals
Claudeget_domain_keyword_suggestions
Claudeget_domain_overview
Claudeget_domain_ranks
Claudeget_google_business_questions
Claudeget_keyword_metrics
Claudeget_landing_page_performance
Claudeget_lead_teardown
Claudeget_local_grid
Claudeget_local_serp_results
Claudeget_rank_history
Claudeget_rank_tracker
Claudeget_ranked_keywords
Claudeget_search_console_performance
Claudeget_search_console_sitemaps
Claudeget_serp_results
Claudeget_upgrade_link
Claudeinspect_urls
Claudelist_business_categories
Claudelist_leads
Claudelist_projects
Claudelist_saved_keywords
Claudelist_share_reports
Claudeprospect_leads
Clauderesearch_keywords
Clauderesearch_lead
Clauderun_local_grid
Clauderun_site_audit
Claudesave_keywords
Claudesearch_local_businesses
Claudeset_cluster_target_page
Claudeset_lead_competitors
Claudeset_lead_serp_checks
Claudeset_lead_top_issues
Claudeupdate_lead
Claudewhoami
Claude