Rankability

Compare two saved campaign snapshots (defaults: the first baseline against the latest). Returns headline changes marked improved, declined, unchanged, or not comparable, the Tracker visibility comparison when recorded, and notes when the prompt set or date ranges differ.

compare_campaign_snapshots

Compare one client's visibility at two dates from existing Tracker results (no scan, no usage). Returns like-for-like AI mention and citation rate changes, cells that gained or lost a mention or citation, organic and local pack position changes, and new or lost competitors. Cells unmeasured on either side are excluded, not counted as losses. Compact by default; view=full returns every change.

compare_visibility

System-admin only. Store a validated report package as a non-public draft. The supplied 128-bit capability id is kept in the database and must never be committed to source control or placed in logs. This tool never publishes the report.

create_ai_seo_audit_report_draft

Create one saved outreach list for a client. This creates workspace state only; it does not discover or enrich prospects.

prospector_create_list

Create one independent Tracker report for exactly one keyword. This does not run an immediate scan. Benchmark mode is the safe default; enable recurring tracking only after the user approves its schedule.

create_tracker_project

Create a client in the organization. Use create_client_connect_link afterward when the user wants to connect GSC or GA4.

create_client

Create the campaign record that becomes the source of truth for a bounded client campaign (goal, market, dates, context, and a prompt set that references existing Tracker reports). This does not create, schedule, or scan Tracker reports.

create_campaign

Create a secure, expiring browser link for a user to authorize Google and select GSC and GA4 properties for a client. Google consent still requires a human. Creating a new link revokes any older active setup link for this client.

create_client_connect_link

Start a Copywriter Autopilot run. Call get_usage_and_limits and estimate_usage_impact, show the current pooled-usage impact, and obtain approval before setting confirm_usage=true.

create_content_autopilot

Create a new content generation job that runs the full pipeline in one call. Call get_usage_and_limits and estimate_usage_impact, show the current pooled-usage impact, and obtain approval before setting confirm_usage=true.

create_content_auto

Create a new content generation job that produces a brief only. Review the brief with get_content_artifacts, then call approve_brief to trigger full draft generation. Use create_content_auto instead if you want the full pipeline in one call.

create_content_stepped

Permanently delete one Copywriter project and its artifacts. Requires the exact current topic as a second confirmation.

delete_content_project

Permanently remove one saved item from a Prospector list. Requires the exact current URL as a second confirmation; it does not delete the source page or contact record outside Rankability.

prospector_delete_item

Permanently delete one saved Prospector list and its list memberships. Requires the exact current list name as a second confirmation.

prospector_delete_list

Permanently delete one Tracker report and its history. The caller must supply the exact current keyword as a second confirmation; use this only when preservation or archiving is not appropriate.

delete_tracker_project

Permanently delete one client Knowledge source. Requires the exact current source name as a second confirmation.

delete_client_source

Permanently delete one client workspace and associated Tracker history. Requires the exact current client name as a second confirmation. Prefer preserving the workspace unless deletion is explicitly requested.

delete_client

Permanently delete a finished Page Auditor audit (status 'complete' or 'error'). Refuses to delete an audit while it is still in progress (any other status) — wait for it to finish, then delete. This cannot be undone.

page_audit_delete

Permanently delete a finished Site Auditor project and all of its crawled pages + detected issues. Refuses to delete a project while its crawl is in progress ('crawling' or 'analyzing') — cancel the crawl first with site_audit_cancel, then delete. This cannot be undone.

site_audit_delete

Extract a grounded answer, highlights, or schema from exactly one URL, organization-owned crawler page, or supplied text. Estimate crawler_extract and obtain approval first. Missing evidence remains null or explicitly unanswered. Rankability Agent API reference: https://help.rankability.com/api/api-getting-started.

extract_page_data

Get the live status of a Copywriter Autopilot run — current stage (queued, researching, briefing, drafting, optimizing, fact_checking, image, finalizing, complete, failed), optimize passes, whether the account entitlement was consumed, and the final review summary. Poll until stage is complete or failed, then use get_content_artifacts to fetch the finished draft.

get_autopilot_status

Read bounded organization-specific Copywriter research and draft queue depth, position, estimated wait, and service alerts.

get_copywriter_queue_status

Read organization-scoped Google Search Console performance at query, page, or query-page grain. Defaults to the latest complete 28-day window, returns at most 100 rows per page, and supports a maximum 120-day range. Position is impression-weighted; empty data is not treated as zero demand.

get_gsc_search_performance

Read durable contradiction-check receipts and completed findings for one Knowledge source. Use this after create_client_source or a content-changing update returns a scheduled check.

get_client_source_contradictions

Read one recurring content or Knowledge-monitor Routine. Content topics or monitored source IDs are paginated; suggested/published topic bodies remain omitted.

routine_get

Read one organization-owned Search Intelligence run. Summary omits answer, citations, organic results, and raw payloads; full includes normalized results, and raw upstream payloads remain opt-in. Rankability Agent API reference: https://help.rankability.com/api/api-getting-started.

search_intelligence_get

Read compact client-level AI citation and mention rates with per-platform coverage and explicit project counts.

get_tracker_brand_summary

Preflight the complete Tracker platform catalog, current-plan entitlement, report capacity (the organization's report limit, current count, and remaining slots, from the same check create and upsert enforce), and client-specific YouTube, TikTok, and Local Pack dependencies before any write or usage-consuming scan. Check remaining_slots before creating a batch of reports.

tracker_capabilities

Read the saved page-level analysis of a Tracker project's cited (ai_citation) or ranking (traditional_search) URLs: source type, URL type, mention status, and opportunity status, matching the app's citation tables. Paginated; reads saved data only.

get_tracker_citation_analysis

Read the domains that most often rank in Google for one Tracker topic, with appearances, latest, best, and average position over the window, matching the app's organic competitor chart. Optional per-scan history.

get_tracker_competitors

Return a bounded client keyword × platform matrix with project_id, keyword, position, mention, citation, measurement state, comparison state, URLs, and freshness without one detail call per keyword. view=summary returns per-project counts plus missing and failed platform lists. client_missing_only keeps only completed checks where the client is absent.

get_tracker_matrix

Get a Tracker project with compact summary output by default. Includes explicit data state, next scheduled run, SPI, platform measurements, and comparison availability; request full only for complete provenance.

get_tracker_project

Legacy compatibility alias for get_tracker_project. Reporter is retained only in the tool ID and API namespace.

get_reporter_project

Read one Tracker project's latest-per-platform, latest-run, or exact-run measurements. Every payload names project_id, client_id, and keyword. Views: summary (one line per platform), compact (default), full (complete AI answers, citations, sentiments, provider diagnostics, and saved provider-returned research_trace fan-out queries when available). Local Pack grids collapse to the representative cell with grid coverage unless local_grid is points or all. Set include_all_results=true for the full ranked lists (Google, Bing, DuckDuckGo, Brave) and Local Pack listings with rating, reviews, phone, and address. client_missing_only keeps only completed checks where the client is absent; failed checks (data_state failed, for example an empty results list) are never counted as missing.

get_tracker_results

List the pages behind one Tracker scan: every ranking URL (traditional_search) and every AI-cited URL (ai_citation), with platform, position, and whether each page mentions the client (mention_status none, linked, linked_elsewhere, unlinked, error, or pending). Use client_missing_only=true to find analyzed pages that rank or are cited without mentioning the client. Paginated; the first page also returns a domain rollup. Reads saved Tracker data only.

get_tracker_sources

High-level latest-per-platform Tracker summary with explicit data_state, nullable SPI/change when unavailable, active project counts, platform coverage, and top movers.

get_tracker_summary

Legacy compatibility alias for get_tracker_summary. Reporter is retained only in the tool ID and API namespace.

get_reporter_summary

Read up to 90 days of completed or partial Tracker runs with SPI and compact per-platform measurements.

get_tracker_trends

Return a canonical client artifact manifest across Tracker, Page Auditor, Site Auditor, Researcher, and Copywriter with lifecycle, supersession, retry provenance, configuration hashes, and batch relationships.

audit_manifest_get

Poll one organization-owned crawl. Status omits pages; summary adds fetch/failure totals; full returns a paginated, field-selected page inventory with compact fields by default. Rankability Agent API reference: https://help.rankability.com/api/api-getting-started.

get_crawl