Technical SEO, passive security and page-delivery audits with evidence and suggested fixes.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Requires the account session, current X-Organization-Id and CSRF for writes. Acknowledge an expected event. Suppress its notice only if sending has not started. Preserve the event and its evidence. Preserve the event and observation. Acknowledgement does not erase a confirmed risk or retract a sent notice. Repetition is idempotent.
Owned tab ID from list_tabs.
Positive history event number.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Requires the account session, current X-Organization-Id and CSRF for writes. Acknowledge an expected event. Suppress its notice only if sending has not started. Preserve the event and its evidence. Preserve the event and observation. Acknowledgement does not erase a confirmed risk or retract a sent notice. Repetition is idempotent.
| Argument | Type | Description |
|---|---|---|
| id* | string | Owned tab ID from list_tabs. |
| number* | integer | Positive history event number. |
{
"type": "object",
"required": [
"id",
"number"
],
"properties": {
"id": {
"type": "string",
"description": "Owned tab ID from list_tabs."
},
"number": {
"type": "integer",
"minimum": 1,
"description": "Positive history event number."
}
}
}Add a site to the account. No site count limit. An account holds up to 1,000 sites (409 site_limit). The existing guest audit workspace stays separate.
| Argument | Type | Description |
|---|---|---|
| url* | string | Public HTTP(S) URL, without credentials. |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Public HTTP(S) URL, without credentials."
}
}
}Read the plan, the saved searches, the last runs and the position trend of each search. Reads never call the search engine. The trend compares each search of the newest run with the previous run that had it: up, down, same, new or lost.
| Argument | Type | Description |
|---|---|---|
| id* | string | Site owned by this account. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Site owned by this account."
}
}
}Check whether the site's page appears in AI search for each target search, at which position, and which sites appear in its place, with plain recommendations. Uses the saved searches or the ones the page suggests when queries is omitted. Send {} to use the saved searches, or the searches the page title and H1 suggest; send {queries} to choose. One index check plus one search per query, each USD 0.00075 when it returns results. Without a watch package: one run per week, three searches. With one: twenty runs per UTC day, ten searches. Result titles and snippets are third-party data.
| Argument | Type | Description |
|---|---|---|
| id* | string | Site owned by this account. |
| lang | string | Language of the recommendations. |
| queries | array | Optional. One to ten searches, 1 to 128 characters each. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Site owned by this account."
},
"lang": {
"enum": [
"en",
"pt"
],
"type": "string",
"description": "Language of the recommendations."
},
"queries": {
"type": "array",
"items": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"maxItems": 10,
"minItems": 1,
"description": "Optional. One to ten searches, 1 to 128 characters each."
}
}
}Discovers the whole PageAudit API (self-describing index).
No arguments.
{
"type": "object",
"properties": {}
}Requires the account session, current X-Organization-Id and CSRF for writes. Apply the reviewed selection. Requires the preview from preview_domain_alerts. A stale preview changes nothing. Select up to 25 saved pages. Repeated registrable domains count once. The server checks the account, organization and current revisions again. A stale preview changes nothing.
| Argument | Type | Description |
|---|---|---|
| tabs* | array | One to 25 owned tab IDs. |
| preview* | string | Exact preview from the POST response for these tabs and lead_days. |
| lead_days* | integer | Days before domain expiry for renewal notices. |
{
"type": "object",
"required": [
"tabs",
"lead_days",
"preview"
],
"properties": {
"tabs": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 25,
"minItems": 1,
"description": "One to 25 owned tab IDs.",
"uniqueItems": true
},
"preview": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "Exact preview from the POST response for these tabs and lead_days."
},
"lead_days": {
"enum": [
7,
14,
30
],
"type": "integer",
"description": "Days before domain expiry for renewal notices."
}
},
"additionalProperties": false
}Check the first 20 URLs of a site's sitemap: status, redirects, robots.txt, noindex, canonical, titles and descriptions. Free, without an account. The same site within one hour returns the stored sample. URLs of another host are counted, never requested. The free sample of the SEO audit. URLs of another host are counted, never requested. The same site within one hour returns the stored sample (`cached_at`) without requesting the site again and without spending the allowance.
| Argument | Type | Description |
|---|---|---|
| url* | string | any address of the site |
| lang | string | optional: pt for the texts in Portuguese |
| guest_token | string | optional pa_… |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "any address of the site"
},
"lang": {
"type": "string",
"description": "optional: pt for the texts in Portuguese"
},
"guest_token": {
"type": "string",
"description": "optional pa_…"
}
}
}Check a web page's search metadata, crawl access, structured data and selected discovery files. Return evidence, limits and suggested changes without creating a saved tab. A blocked target returns HTTP 502 with target_blocked. The report does not certify security or accessibility. This is the product for agents. The free alternative: a person signs in with an account to get the trial.
| Argument | Type | Description |
|---|---|---|
| url* | string | absolute URL to audit |
| guest_token | string | optional pa_… |
| compare_with | string | optional ID of an earlier audit of the same owner; returns what appeared and disappeared |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "absolute URL to audit"
},
"guest_token": {
"type": "string",
"description": "optional pa_…"
},
"compare_with": {
"type": "string",
"description": "optional ID of an earlier audit of the same owner; returns what appeared and disappeared"
}
}
}Requires the account session, current X-Organization-Id and CSRF for writes. Cancel the current TLS review and preserve completed evidence. One review per account, organization, origin and UTC day. Starting requires current domain monitoring rights. The account has three starts per UTC day. Retries return the same review. The scanner samples one public IP, with three stages and a 170-second deadline. Partial results do not establish safety. GET never starts a scan. The shared realtime channel reports stage changes. Reports expire after 26 hours.
| Argument | Type | Description |
|---|---|---|
| id* | string | Owned tab ID from list_tabs. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Owned tab ID from list_tabs."
}
},
"additionalProperties": false
}Request a page as Googlebot, Bingbot and the AI crawlers (OAI-SearchBot, Claude-SearchBot, PerplexityBot, ChatGPT-User, GPTBot, ClaudeBot) and see who gets a 403, a 429 or a firewall challenge that robots.txt does not show. Also returns the date of the newest sitemap lastmod and whether Cloudflare is in front. Free, without an account. The same page within one hour returns the stored result. The page is requested with the published user agent of Googlebot, Bingbot, OAI-SearchBot, Claude-SearchBot, PerplexityBot, ChatGPT-User, GPTBot, ClaudeBot, and once as a browser. A 403, a 429 or a firewall challenge that only a crawler gets is the block that robots.txt does not show. The sitemap is the one that robots.txt declares, or `/sitemap.xml`; it is stale when its newest `lastmod` is more than 30 days old. Limit: Cloudflare recognises the real crawler by its IP address, so a rule that trusts verified bots can treat the real crawler differently. The same page within one hour returns the stored result (`cached_at`) without requesting the site again.
| Argument | Type | Description |
|---|---|---|
| url* | string | the page to check |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "the page to check"
}
}
}Refresh due registration, contacts, TLS, DNS, mail policies, certificate issuance and a limited DNS/TLS sample. Reuses fresh public data. Reuse fresh observations. A failed or partial query preserves the last complete observation and its date. Up to 100 cold page reads per owner and UTC day.
| Argument | Type | Description |
|---|---|---|
| id* | string | Owned tab ID from list_tabs. |
| guest_token | string |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Owned tab ID from list_tabs."
},
"guest_token": {
"type": "string"
}
}
}Requires the account session, current X-Organization-Id and CSRF for writes. Set up to three known DKIM selectors and choose whether IP rotation is expected. Expected rotation keeps history without notices; alias changes still notify. Does not discover selectors, enable monitoring or authenticate sent messages. Send manual_expires_on, dns, or both. Omitted settings are preserved. DNS requires both selectors and rotating_addresses. An identical retry is idempotent. A conflicting revision returns 409.
| Argument | Type | Description |
|---|---|---|
| id* | string | Owned tab ID from list_tabs. |
| dns* | object | Known selectors and expected IP rotation. Selector discovery is not performed. |
| revision* | integer | Current revision from the corresponding settings or monitor. Use zero for the first change. |
{
"type": "object",
"required": [
"id",
"revision",
"dns"
],
"properties": {
"id": {
"type": "string",
"description": "Owned tab ID from list_tabs."
},
"dns": {
"type": "object",
"required": [
"dkim_selectors",
"rotating_addresses"
],
"properties": {
"dkim_selectors": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._-]*$",
"maxLength": 63
},
"maxItems": 3,
"uniqueItems": true
},
"rotating_addresses": {
"type": "boolean"
}
},
"description": "Known selectors and expected IP rotation. Selector discovery is not performed.",
"additionalProperties": false
},
"revision": {
"type": "integer",
"minimum": 0,
"description": "Current revision from the corresponding settings or monitor. Use zero for the first change."
}
},
"additionalProperties": false
}Requires the account session, current X-Organization-Id and CSRF for writes. Enable or stop domain monitoring, or pause notices for maintenance. Count a registry domain once per account, including its organization copies. Add only the tab's origin. HTTP receives DNS checks only. Maintenance pauses notices while collection continues. Confirm enabled, no suspension and next_check_at after saving.
| Argument | Type | Description |
|---|---|---|
| id* | string | Owned tab ID from list_tabs. |
| enabled* | boolean | True enables collection; false stops it. |
| revision* | integer | Current revision from the corresponding settings or monitor. Use zero for the first change. |
| maintenance_until* | integer | null | Future Unix milliseconds within 30 days, or null. |
{
"type": "object",
"required": [
"id",
"revision",
"enabled",
"maintenance_until"
],
"properties": {
"id": {
"type": "string",
"description": "Owned tab ID from list_tabs."
},
"enabled": {
"type": "boolean",
"description": "True enables collection; false stops it."
},
"revision": {
"type": "integer",
"minimum": 0,
"description": "Current revision from the corresponding settings or monitor. Use zero for the first change."
},
"maintenance_until": {
"type": [
"integer",
"null"
],
"description": "Future Unix milliseconds within 30 days, or null."
}
}
}Start read-only Google consent. The account owner must follow redirect in their browser. Follow redirect in the account's browser. Consent expires after five minutes. The callback is single-use and bound to the account and site. The property must match the site and Google must authorize it before the connection is saved.
| Argument | Type | Description |
|---|---|---|
| id* | string | Site ID from list_sites or add_site. |
| language | string | en (default) or pt. Browser consent returns in this language. |
| property* | string | Exact Search Console domain or URL-prefix property. |
{
"type": "object",
"required": [
"id",
"property"
],
"properties": {
"id": {
"type": "string",
"description": "Site ID from list_sites or add_site."
},
"language": {
"enum": [
"en",
"pt"
],
"type": "string",
"description": "en (default) or pt. Browser consent returns in this language."
},
"property": {
"type": "string",
"description": "Exact Search Console domain or URL-prefix property."
}
}
}Requires the account session, current X-Organization-Id and CSRF for writes. Read today's private TLS review without starting a scan. One review per account, organization, origin and UTC day. Starting requires current domain monitoring rights. The account has three starts per UTC day. Retries return the same review. The scanner samples one public IP, with three stages and a 170-second deadline. Partial results do not establish safety. GET never starts a scan. The shared realtime channel reports stage changes. Reports expire after 26 hours.
| Argument | Type | Description |
|---|---|---|
| id* | string | Owned tab ID from list_tabs. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Owned tab ID from list_tabs."
}
},
"additionalProperties": false
}Write to the people behind the product: a question, or a sponsorship/partnership/advertising proposal. One route for a question and for a sponsorship, partnership or ad proposal (`tipo`, with the placements of `GET /api/partners`). One message every 10 seconds per network: one that arrives sooner waits its turn and then goes out — no error. The message reaches the team by e-mail, with `email` as the reply address. For voice, send multipart/form-data: `dados` is this JSON (up to 32 KiB), and `audio` is one WebM, Ogg or M4A audio file (up to 2 MB). Audio can replace message. The browser records up to two minutes. Audio is attached to the owner's e-mail.
| Argument | Type | Description |
|---|---|---|
| fuso | string | Consulting: the IANA time zone, such as `America/New_York`. |
| name* | string | What to call the person writing. |
| pais | string | Consulting: the country of the person asking. |
| site | string | Website of who is proposing. |
| tipo | string | Proposal: `patrocinio`, `parceria`, `anuncio` or `consultoria`. Turns on the fields below. |
| email* | string | Where to reply. |
| prazo | string | Consulting: when to start (`agora`, `1_mes`, `1_3_meses` or `explorando`). |
Creates a guest token pa_… for the tab workspace. Keep the token: it is the identity of the tabs and of the audits tied to them.
No arguments.
{
"type": "object",
"properties": {}
}Opens a saved URL. Set queue_audit=false to monitor a discovered origin without a page audit.
| Argument | Type | Description |
|---|---|---|
| url* | string | The URL the tab will follow. |
| alias | string | Label to recognise the tab in the list. |
| guest_token* | string | |
| queue_audit | boolean | Defaults to true. Use false to save an idle page for domain monitoring without queuing a page audit. Existing pages keep their current state. |
{
"type": "object",
"required": [
"guest_token",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "The URL the tab will follow."
},
"alias": {
"type": "string",
"description": "Label to recognise the tab in the list."
},
"guest_token": {
"type": "string"
},
"queue_audit": {
"type": "boolean",
"default": true,
"description": "Defaults to true. Use false to save an idle page for domain monitoring without queuing a page audit. Existing pages keep their current state."
}
}
}Remove the local Google credential and stop collection. Keep the last good sample. The last good sample stays available. An in-flight callback or collection cannot reconnect the site.
| Argument | Type | Description |
|---|---|---|
| id* | string | Site ID from list_sites or add_site. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Site ID from list_sites or add_site."
}
}
}Requires the account session, current X-Organization-Id and CSRF for writes. Read up to 50 private incidents with notice delivery. Send the last event number as before for the next page. A first observed risk is an initial incident, not evidence of an external change. The first DNS and certificate-issuance snapshots are silent baselines. DNS changes, incompatible server samples and connection failures need two distinct observations. Expected IP rotation is silent. Repeated observations do not duplicate a notice. Contact changes expose field states only. Issuance does not prove installation. DNS records do not prove authentication of sent mail.
| Argument | Type | Description |
|---|---|---|
| id* | string | Owned tab ID from list_tabs. |
| before | integer | Return events with a number below this cursor. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Owned tab ID from list_tabs."
},
"before": {
"type": "integer",
"minimum": 1,
"description": "Return events with a number below this cursor."
}
}
}Requires the account session, current X-Organization-Id and CSRF for writes. Read cached domain monitoring and deadlines for selected saved pages. Does not start external collection or activate monitoring. Every tab must belong to the current account and organization. Repeat with the next group of IDs for a larger workspace.
| Argument | Type | Description |
|---|---|---|
| tabs* | array | One to 100 owned tab IDs. |
{
"type": "object",
"required": [
"tabs"
],
"properties": {
"tabs": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 100,
"minItems": 1,
"description": "One to 100 owned tab IDs.",
"uniqueItems": true
}
},
"additionalProperties": false
}Read registration, contact visibility, TLS, DNS, CAA, mail policies, certificate issuance and a limited server comparison. Read source dates and collection gaps. Private options require the account session. A discovered name never starts monitoring automatically. Pages share public observations by registry domain and HTTPS origin. Private settings and history stay with the account and organization. Missing data is not a healthy result.
| Argument | Type | Description |
|---|---|---|
| id* | string | Owned tab ID from list_tabs. |
| guest_token | string |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Owned tab ID from list_tabs."
},
"guest_token": {
"type": "string"
}
}
}The embeddable widget's snippet, already assembled with the site's name and colour — one script tag, no account, no lead capture. One script tag puts the audit form on your own site, with your name and colour, and no account or key. Send the same query you would send to `/embed` and the answer comes back with `snippet` already assembled. The widget never asks the visitor for an e-mail.
| Argument | Type | Description |
|---|---|---|
| url | string | optional URL to pre-fill |
| brand | string | site name shown above the form |
| color | string | accent colour in hex |
| theme | string | auto, light or dark |
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "optional URL to pre-fill"
},
"brand": {
"type": "string",
"description": "site name shown above the form"
},
"color": {
"type": "string",
"description": "accent colour in hex"
},
"theme": {
"type": "string",
"description": "auto, light or dark"
}
}
}Generate a fix prompt from saved domain observations. Prepare a coding-agent prompt from an owned report within the free allowance or active plan. Read prompt_allowance first. A check uses one unit; full uses three. Preserve request_id for retries.
| Argument | Type | Description |
|---|---|---|
| id* | string | Owned tab in the active organization ID. |
| scope* | string | check or full. |
| source* | string | domain: the saved registration, certificate, DNS and email observations of the tab. |
| check_id | string | registration, certificate, dns or email. Required for check; absent for full. |
| language* | string | Language of the prompt instructions and check names: en for English, pt for Portuguese. |
| request_id* | string | New UUID v4 per generation. Keep it unchanged for retries. |
| guest_token | string |
{
"type": "object",
"required": [
"id",
"scope",
"language",
"request_id",
"source"
],
"properties": {
"id": {
"type": "string",
"description": "Owned tab in the active organization ID."
},
"scope": {
"enum": [
"check",
"full"
],
"type": "string",
"description": "check or full."
},
"source": {
"enum": [
"domain"
],
"type": "string",
"description": "domain: the saved registration, certificate, DNS and email observations of the tab."
},
"check_id": {
"type": "string",
"description": "registration, certificate, dns or email. Required for check; absent for full."
},
"language": {
"enum": [
"en",
"pt"
],
"type": "string",
"description": "Language of the prompt instructions and check names: en for English, pt for Portuguese."
},
"request_id": {
"type": "string",
"format": "uuid",
"description": "New UUID v4 per generation. Keep it unchanged for retries."
},
"guest_token": {
"type": "string"
}
}
}Prepare a coding-agent prompt from an owned report within the free allowance or active plan. Read prompt_allowance first. A check uses one unit; full uses three. Preserve request_id for retries.
| Argument | Type | Description |
|---|---|---|
| id* | string | Owned saved audit ID. |
| scope* | string | check or full. |
| check_id | string | ID from the report's checks; required for check, absent for full. |
| language* | string | Language of the prompt instructions and check names: en for English, pt for Portuguese. |
| request_id* | string | New UUID v4 per generation. Keep it unchanged for retries. |
| guest_token | string |
{
"type": "object",
"required": [
"id",
"scope",
"language",
"request_id"
],
"properties": {
"id": {
"type": "string",
"description": "Owned saved audit ID."
},
"scope": {
"enum": [
"check",
"full"
],
"type": "string",
"description": "check or full."
},
"check_id": {
"type": "string",
"description": "ID from the report's checks; required for check, absent for full."
},
"language": {
"enum": [
"en",
"pt"
],
"type": "string",
"description": "Language of the prompt instructions and check names: en for English, pt for Portuguese."
},
"request_id": {
"type": "string",
"format": "uuid",
"description": "New UUID v4 per generation. Keep it unchanged for retries."
},
"guest_token": {
"type": "string"
}
}
}Generate a fix prompt for a weekly finding or a Search Console opportunity. Prepare a coding-agent prompt from an owned report within the free allowance or active plan. Read prompt_allowance first. A check uses one unit; full uses three. Preserve request_id for retries.
| Argument | Type | Description |
|---|---|---|
| id* | string | Owned site ID. |
| query | string | Exact opportunity query; required for Search Console check. |
| scope* | string | check or full. |
| source* | string | weekly: a finding of a saved weekly report. search_console: a saved Search Console opportunity. |
| check_id | string | Weekly finding type, or opportunity for Search Console. Required for check; absent for full. |
| language* | string | Language of the prompt instructions and check names: en for English, pt for Portuguese. |
| report_id | string | Required for weekly: saved report ID. |
| request_id* | string | New UUID v4 per generation. Keep it unchanged for retries. |
Re-read an audit with its findings and evidence. Use generate_fix_prompt for correction steps.
| Argument | Type | Description |
|---|---|---|
| id* | string | Audit ID, from `Audit.id`. |
| guest_token* | string |
{
"type": "object",
"required": [
"guest_token",
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Audit ID, from `Audit.id`."
},
"guest_token": {
"type": "string"
}
}
}Metadata and markdown of the SVG badge of a shared report.
| Argument | Type | Description |
|---|---|---|
| slug* | string | 24-char public slug |
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "24-char public slug"
}
}
}Read a saved prompt. Preserve the complete prompt and license. Use it only for license.domain. This does not authorize deployments or infrastructure changes. Uses the authenticated owner and active organization. Returns the immutable text. A missing or foreign prompt returns 404.
| Argument | Type | Description |
|---|---|---|
| id* | string | Saved prompt ID from generation or the private list. |
| guest_token | string |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Saved prompt ID from generation or the private list."
},
"guest_token": {
"type": "string"
}
}
}Read one site owned by the signed-in account.
| Argument | Type | Description |
|---|---|---|
| id* | string | Site ID from list_sites or add_site. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Site ID from list_sites or add_site."
}
}
}Copy and checks of one micro-tool by slug (e.g. title-tag-checker).
| Argument | Type | Description |
|---|---|---|
| slug* | string | tool slug |
| language | string | Content language: pt (also pt-BR) for Portuguese; any other value or none returns English. |
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "tool slug"
},
"language": {
"enum": [
"en",
"pt"
],
"type": "string",
"description": "Content language: pt (also pt-BR) for Portuguese; any other value or none returns English."
}
}
}Liveness and the commit deployed right now — it is how the smoke waits for its own deploy.
No arguments.
{
"type": "object",
"properties": {}
}Read the owned site's installation, actions, paths and ordered conversion funnel for the last seven days. Requires the account's browser session. Only this site's owner can read it. Data updates through the shared realtime transport. No user identity, typed text or screen recording.
| Argument | Type | Description |
|---|---|---|
| id* | string | Owned Site.id. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Owned Site.id."
}
}
}The lab tests of an audit (mobile and desktop): running, finished with scores, metrics and biggest savings, or failed. With wait (up to 25) it answers as soon as a running test finishes. Long-poll: with `wait` the answer comes as soon as a running test finishes, or after `wait` seconds with `status: running`. Repeat until it is not running.
| Argument | Type | Description |
|---|---|---|
| id* | string | audit id |
| wait | number | seconds to wait for a running test, 0–25 |
| guest_token* | string |
{
"type": "object",
"required": [
"guest_token",
"id"
],
"properties": {
"id": {
"type": "string",
"description": "audit id"
},
"wait": {
"type": "number",
"description": "seconds to wait for a running test, 0–25"
},
"guest_token": {
"type": "string"
}
}
}Starts a lab test of an audit's page: Lighthouse run by Google PageSpeed Insights (performance, accessibility, best practices, SEO). Answers 202 at once; the test takes ~25 s to 2+ minutes — then read it with lab_result. Does not change the audit score. Answers **202** at once; the test runs for ~25 s to over 2 minutes and its summary is stored in the audit (`summary.lab.<strategy>`), so it comes back in `GET /api/audits/:id`, in the tab and in the shared report. It does not change the audit score. Calling again while the same strategy is running does not start a second test. Limits: 4 tests at a time on the server, 6 per network per hour and 500 per day for the whole product.
| Argument | Type | Description |
|---|---|---|
| id* | string | audit id |
| strategy | string | mobile (default) or desktop |
| guest_token* | string |
{
"type": "object",
"required": [
"guest_token",
"id"
],
"properties": {
"id": {
"type": "string",
"description": "audit id"
},
"strategy": {
"type": "string",
"description": "mobile (default) or desktop"
},
"guest_token": {
"type": "string"
}
}
}Find saved audits prompts before generation. Listing is free. Keep language and source filters when following the cursor. At most 100 saved rows per page, plus up to three earlier free audit receipts. Follow _links.next. The result belongs to the authenticated owner and active organization.
| Argument | Type | Description |
|---|---|---|
| id* | string | Owned source ID. |
| after | string | Cursor from the preceding page. |
| language | string | Prompt language: en (default) for English or pt for Portuguese. |
| guest_token | string |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Owned source ID."
},
"after": {
"type": "string",
"description": "Cursor from the preceding page."
},
"language": {
"enum": [
"en",
"pt"
],
"type": "string",
"description": "Prompt language: en (default) for English or pt for Portuguese."
},
"guest_token": {
"type": "string"
}
}
}Find saved tabs prompts before generation. Listing is free. Keep language and source filters when following the cursor. At most 100 saved rows per page, plus up to three earlier free audit receipts. Follow _links.next. The result belongs to the authenticated owner and active organization.
| Argument | Type | Description |
|---|---|---|
| id* | string | Owned source ID. |
| after | string | Cursor from the preceding page. |
| source* | string | domain: the saved domain observations of the tab. |
| language | string | Prompt language: en (default) for English or pt for Portuguese. |
| guest_token | string |
{
"type": "object",
"required": [
"id",
"source"
],
"properties": {
"id": {
"type": "string",
"description": "Owned source ID."
},
"after": {
"type": "string",
"description": "Cursor from the preceding page."
},
"source": {
"enum": [
"domain"
],
"type": "string",
"description": "domain: the saved domain observations of the tab."
},
"language": {
"enum": [
"en",
"pt"
],
"type": "string",
"description": "Prompt language: en (default) for English or pt for Portuguese."
},
"guest_token": {
"type": "string"
}
}
}Find saved sites prompts before generation. Listing is free. Keep language and source filters when following the cursor. At most 100 saved rows per page, plus up to three earlier free audit receipts. Follow _links.next. The result belongs to the authenticated owner and active organization.
| Argument | Type | Description |
|---|---|---|
| id* | string | Owned source ID. |
| after | string | Cursor from the preceding page. |
| source* | string | weekly: a saved weekly report. search_console: saved Search Console opportunities. |
| language | string | Prompt language: en (default) for English or pt for Portuguese. |
| report_id | string | Required for weekly. |
| guest_token | string |
{
"type": "object",
"required": [
"id",
"source"
],
"properties": {
"id": {
"type": "string",
"description": "Owned source ID."
},
"after": {
"type": "string",
"description": "Cursor from the preceding page."
},
"source": {
"enum": [
"weekly",
"search_console"
],
"type": "string",
"description": "weekly: a saved weekly report. search_console: saved Search Console opportunities."
},
"language": {
"enum": [
"en",
"pt"
],
"type": "string",
"description": "Prompt language: en (default) for English or pt for Portuguese."
},
"report_id": {
"type": "string",
"description": "Required for weekly."
},
"guest_token": {
"type": "string"
}
}
}Read up to 50 sites owned by the signed-in account. Follow next_cursor.
| Argument | Type | Description |
|---|---|---|
| host | string | Exact lowercase domain without www. Returns at most one owned site, Search Console, Analytics and site-package state in the same response. Does not create a site. |
| cursor | string | next_cursor from the preceding page. |
{
"type": "object",
"properties": {
"host": {
"type": "string",
"description": "Exact lowercase domain without www. Returns at most one owned site, Search Console, Analytics and site-package state in the same response. Does not create a site."
},
"cursor": {
"type": "string",
"description": "next_cursor from the preceding page."
}
}
}Lists the owner's saved pages (guest or session), with the active page's last report. Group pages by site to match the Projects table. One call loads the saved pages and the active page's last report. The UI groups pages by site in Projects and opens each site in a work tab. The introduction stays in Welcome. A signed-in account sends `X-Organization-Id`; a guest has one temporary workspace.
| Argument | Type | Description |
|---|---|---|
| guest_token* | string |
{
"type": "object",
"required": [
"guest_token"
],
"properties": {
"guest_token": {
"type": "string"
}
}
}Lists the micro-tools (title, meta, canonical, OG, JSON-LD…).
| Argument | Type | Description |
|---|---|---|
| language | string | Content language: pt (also pt-BR) for Portuguese; any other value or none returns English. |
{
"type": "object",
"properties": {
"language": {
"enum": [
"en",
"pt"
],
"type": "string",
"description": "Content language: pt (also pt-BR) for Portuguese; any other value or none returns English."
}
}
}Requires the account session, current X-Organization-Id and CSRF for writes. Review the exact selected domains before changing renewal notices. Select up to 25 saved pages. Repeated registrable domains count once. The server checks the account, organization and current revisions again. A stale preview changes nothing.
| Argument | Type | Description |
|---|---|---|
| tabs* | array | One to 25 owned tab IDs. |
| lead_days* | integer | Days before domain expiry for renewal notices. |
{
"type": "object",
"required": [
"tabs",
"lead_days"
],
"properties": {
"tabs": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 25,
"minItems": 1,
"description": "One to 25 owned tab IDs.",
"uniqueItems": true
},
"lead_days": {
"enum": [
7,
14,
30
],
"type": "integer",
"description": "Days before domain expiry for renewal notices."
}
},
"additionalProperties": false
}Read remaining prompt units before generating.
| Argument | Type | Description |
|---|---|---|
| guest_token | string |
{
"type": "object",
"properties": {
"guest_token": {
"type": "string"
}
}
}Requires the account session, current X-Organization-Id and CSRF for writes. Start a TLS review of the saved HTTPS origin using current domain monitoring rights. At most three starts per account and UTC day, one per site. A repeated request reuses today's review. Do not claim complete safety from a partial result. One review per account, organization, origin and UTC day. Starting requires current domain monitoring rights. The account has three starts per UTC day. Retries return the same review. The scanner samples one public IP, with three stages and a 170-second deadline. Partial results do not establish safety. GET never starts a scan. The shared realtime channel reports stage changes. Reports expire after 26 hours.
| Argument | Type | Description |
|---|---|---|
| id* | string | Owned tab ID from list_tabs. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Owned tab ID from list_tabs."
}
},
"additionalProperties": false
}Re-audits the tab's URL.
| Argument | Type | Description |
|---|---|---|
| id* | string | ID of the tab to re-audit. |
| guest_token* | string |
{
"type": "object",
"required": [
"guest_token",
"id"
],
"properties": {
"id": {
"type": "string",
"description": "ID of the tab to re-audit."
},
"guest_token": {
"type": "string"
}
}
}Save up to ten searches for the weekly report to track (three without a watch package). Saves use the expected version. Without a current watch package, an account tracks up to three searches. Uses the shared 240 writes per site and UTC day.
| Argument | Type | Description |
|---|---|---|
| id* | string | Site owned by this account. |
| queries* | array | One to ten distinct searches, 1 to 128 characters each. |
| version* | integer | 0 initially; then the current settings version. |
{
"type": "object",
"required": [
"id",
"version",
"queries"
],
"properties": {
"id": {
"type": "string",
"description": "Site owned by this account."
},
"queries": {
"type": "array",
"items": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"maxItems": 10,
"minItems": 1,
"description": "One to ten distinct searches, 1 to 128 characters each."
},
"version": {
"type": "integer",
"minimum": 0,
"description": "0 initially; then the current settings version."
}
}
}Turn the weekly report of a site on or off and set up to 3 competitors. Turning on needs a watch package in force. Turning on needs a watch package in force and a free site in it (409 with `limit` and `plans` otherwise). The first report runs right away; later ones run a week after the last. A new competitor gets its base this week and its new pages from the next. Saves use the expected version.
| Argument | Type | Description |
|---|---|---|
| id* | string | Site owned by this account. |
| paused* | boolean | `false` turns the weekly report on; `true` turns it off. |
| version* | integer | 0 the first time; then `settings.version`. |
| competitors* | array | Up to 3 competitor sites (any address; the report reads the origin's /sitemap.xml). |
{
"type": "object",
"required": [
"id",
"version",
"paused",
"competitors"
],
"properties": {
"id": {
"type": "string",
"description": "Site owned by this account."
},
"paused": {
"type": "boolean",
"description": "`false` turns the weekly report on; `true` turns it off."
},
"version": {
"type": "integer",
"minimum": 0,
"description": "0 the first time; then `settings.version`."
},
"competitors": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 3,
"description": "Up to 3 competitor sites (any address; the report reads the origin's /sitemap.xml)."
}
}
}Read own-site keywords, opportunities at average positions 4–20, up to 20 tracked queries and daily history. Check dates, partial coverage and collection failure before proposing edits. These are not market search volumes. The sample covers 28 days, at most 50 queries and 50 pages. Use queries for keyword research and opportunities for average positions 4–20. The terms array adds daily history and 7-day comparisons for up to 20 selected queries. Coverage is partial: impressions are for this property, not market search volume. Positions are impression-weighted averages, not fixed SERP ranks. Credentials and raw provider responses are not returned.
| Argument | Type | Description |
|---|---|---|
| id* | string | Site ID from list_sites or add_site. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Site ID from list_sites or add_site."
}
}
}Requires the account session, current X-Organization-Id and CSRF for writes. Set or remove the private manual expiry. Send manual_expires_on, dns, or both. Omitted settings are preserved. DNS requires both selectors and rotating_addresses. An identical retry is idempotent. A conflicting revision returns 409.
| Argument | Type | Description |
|---|---|---|
| id* | string | Owned tab ID from list_tabs. |
| revision* | integer | Current revision from the corresponding settings or monitor. Use zero for the first change. |
| manual_expires_on* | string | null | YYYY-MM-DD, or null to remove. |
{
"type": "object",
"required": [
"id",
"revision",
"manual_expires_on"
],
"properties": {
"id": {
"type": "string",
"description": "Owned tab ID from list_tabs."
},
"revision": {
"type": "integer",
"minimum": 0,
"description": "Current revision from the corresponding settings or monitor. Use zero for the first change."
},
"manual_expires_on": {
"type": [
"string",
"null"
],
"description": "YYYY-MM-DD, or null to remove."
}
}
}Collect a due sample. Repeated calls cannot bypass the daily reservation. The hourly schedule uses the same durable reservation. A failure preserves the last good sample and schedules the next attempt 24 hours later. This route cannot force an extra collection.
| Argument | Type | Description |
|---|---|---|
| id* | string | Site ID from list_sites or add_site. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Site ID from list_sites or add_site."
}
}
}The tab's previous runs and what changed between each one and the one before it (score delta, findings that appeared and that disappeared). Every run has always been kept; this is where you read the series. Each entry carries the score, the counts and a `change` with the point delta and the findings that appeared (`broke`) or disappeared (`fixed`) since the previous run — compared by finding code, never by message. Runs older than the watch feature are matched by URL.
| Argument | Type | Description |
|---|---|---|
| id* | string | ID of the tab whose runs you want. |
| limit | number | how many runs, newest first (default 20, max 100) |
| guest_token* | string |
{
"type": "object",
"required": [
"guest_token",
"id"
],
"properties": {
"id": {
"type": "string",
"description": "ID of the tab whose runs you want."
},
"limit": {
"type": "number",
"description": "how many runs, newest first (default 20, max 100)"
},
"guest_token": {
"type": "string"
}
}
}Replace the site's tracked query selection (up to 20). Read search_console first to preserve existing selections. Removed queries keep their stored history. E-mail alerts require an active site package. Accepts up to 20 exact queries. Removed queries become inactive; their stored history is retained. Saving schedules the Search Console connection for collection. E-mail delivery requires an active site package.
| Argument | Type | Description |
|---|---|---|
| id* | string | Site ID from list_sites or add_site. |
| terms* | array | Unique exact queries, each 1–300 characters. |
{
"type": "object",
"required": [
"id",
"terms"
],
"properties": {
"id": {
"type": "string",
"description": "Site ID from list_sites or add_site."
},
"terms": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300,
"minLength": 1
},
"maxItems": 20,
"description": "Unique exact queries, each 1–300 characters.",
"uniqueItems": true
}
}
}Turns the daily watch on or off for a tab: it re-audits the page once a day and e-mails when the score drops or a new error/warning appears. Needs the signed-in account (its browser session cookie); a guest token gets 403 `account_required`. With `monitor: true` the page is re-audited once a day and an e-mail goes out when the score drops or a new error/warning appears — never on an improvement. Watching needs an account (the alert has to reach someone) and each account watches a limited number of pages.
| Argument | Type | Description |
|---|---|---|
| id* | string | ID of the tab to change. |
| monitor* | boolean | true watches, false stops watching |
| guest_token* | string | guest pa_… — refused: a guest has no e-mail to warn |
| monitor_email | string | where the alert goes; empty = account e-mail |
{
"type": "object",
"required": [
"guest_token",
"id",
"monitor"
],
"properties": {
"id": {
"type": "string",
"description": "ID of the tab to change."
},
"monitor": {
"type": "boolean",
"description": "true watches, false stops watching"
},
"guest_token": {
"type": "string",
"description": "guest pa_… — refused: a guest has no e-mail to warn"
},
"monitor_email": {
"type": "string",
"description": "where the alert goes; empty = account e-mail"
}
}
}Read the weekly report of a site: what changed since last week, the new pages of up to 3 competitors and every finding. Reading never runs the report. Once a week the report checks the first 500 URLs of the site's sitemap, says what changed since the week before (new and fixed problems, new pages) and lists the new pages of up to 3 competitor sitemaps. Reading never runs the report.
| Argument | Type | Description |
|---|---|---|
| id* | string | Site owned by this account. |
| lang | string | optional: pt for the texts in Portuguese |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Site owned by this account."
},
"lang": {
"type": "string",
"description": "optional: pt for the texts in Portuguese"
}
}
}Read one weekly report of a site's history by its id.
| Argument | Type | Description |
|---|---|---|
| id* | string | Site owned by this account. |
| lang | string | optional: pt for the texts in Portuguese |
| report* | string | A report id from history. |
{
"type": "object",
"required": [
"id",
"report"
],
"properties": {
"id": {
"type": "string",
"description": "Site owned by this account."
},
"lang": {
"type": "string",
"description": "optional: pt for the texts in Portuguese"
},
"report": {
"type": "string",
"description": "A report id from history."
}
}
}| espaco |
| array |
| Placement ids from `GET /api/partners`, up to 6. |
| duracao | string | Exposure in days: `30`, `90` or `365`. |
| empresa | string | Who is proposing, when it is a company. |
| formato | string | Consulting: `projeto` (per scope), `mensal` (monthly) or `assessoria` (advisory). |
| message* | string | What you want to say. |
| projeto | string | Consulting: the kind of project (`llm_privado`, `voz`, `dados_sensiveis`, `gpu`, `integracao` or `outro`). |
| horarios | array | Consulting: up to 3 times for the call, `YYYY-MM-DDTHH:MM` in that time zone. |
| string | Optional reply number with country code, such as +5561999999999. |
| orcamento | string | Advertising: `ate_100`, `100_500`, `500_2000`, `2000_mais` or `a_combinar`. Consulting, in US dollars: `ate_2000`, `2000_5000`, `5000_10000`, `10000_mais` or `nao_sei`. |
| pagamento | string |
| prefer_whatsapp | boolean | Request a WhatsApp reply. Requires whatsapp. |
{
"type": "object",
"required": [
"name",
"email",
"message"
],
"properties": {
"fuso": {
"type": "string",
"description": "Consulting: the IANA time zone, such as `America/New_York`."
},
"name": {
"type": "string",
"description": "What to call the person writing."
},
"pais": {
"type": "string",
"description": "Consulting: the country of the person asking."
},
"site": {
"type": "string",
"description": "Website of who is proposing."
},
"tipo": {
"enum": [
"patrocinio",
"parceria",
"anuncio",
"consultoria"
],
"type": "string",
"description": "Proposal: `patrocinio`, `parceria`, `anuncio` or `consultoria`. Turns on the fields below."
},
"email": {
"type": "string",
"description": "Where to reply."
},
"prazo": {
"enum": [
"agora",
"1_mes",
"1_3_meses",
"explorando"
],
"type": "string",
"description": "Consulting: when to start (`agora`, `1_mes`, `1_3_meses` or `explorando`)."
},
"espaco": {
"type": "array",
"items": {
"type": "string"
},
"description": "Placement ids from `GET /api/partners`, up to 6."
},
"duracao": {
"enum": [
"30",
"90",
"365"
],
"type": "string",
"description": "Exposure in days: `30`, `90` or `365`."
},
"empresa": {
"type": "string",
"description": "Who is proposing, when it is a company."
},
"formato": {
"enum": [
"projeto",
"mensal",
"assessoria"
],
"type": "string",
"description": "Consulting: `projeto` (per scope), `mensal` (monthly) or `assessoria` (advisory)."
},
"message": {
"type": "string",
"description": "What you want to say."
},
"projeto": {
"enum": [
"llm_privado",
"voz",
"dados_sensiveis",
"gpu",
"integracao",
"outro"
],
"type": "string",
"description": "Consulting: the kind of project (`llm_privado`, `voz`, `dados_sensiveis`, `gpu`, `integracao` or `outro`)."
},
"horarios": {
"type": "array",
"items": {
"type": "string"
},
"description": "Consulting: up to 3 times for the call, `YYYY-MM-DDTHH:MM` in that time zone."
},
"whatsapp": {
"type": "string",
"description": "Optional reply number with country code, such as +5561999999999."
},
"orcamento": {
"enum": [
"ate_100",
"100_500",
"500_2000",
"2000_mais",
"a_combinar",
"ate_2000",
"2000_5000",
"5000_10000",
"10000_mais",
"nao_sei"
],
"type": "string",
"description": "Advertising: `ate_100`, `100_500`, `500_2000`, `2000_mais` or `a_combinar`. Consulting, in US dollars: `ate_2000`, `2000_5000`, `5000_10000`, `10000_mais` or `nao_sei`."
},
"pagamento": {
"enum": [
"usdc",
"deposito",
"a_combinar"
],
"type": "string"
},
"prefer_whatsapp": {
"type": "boolean",
"description": "Request a WhatsApp reply. Requires whatsapp."
}
}
}| guest_token | string |
{
"type": "object",
"required": [
"id",
"scope",
"language",
"request_id",
"source"
],
"properties": {
"id": {
"type": "string",
"description": "Owned site ID."
},
"query": {
"type": "string",
"maxLength": 1024,
"description": "Exact opportunity query; required for Search Console check."
},
"scope": {
"enum": [
"check",
"full"
],
"type": "string",
"description": "check or full."
},
"source": {
"enum": [
"weekly",
"search_console"
],
"type": "string",
"description": "weekly: a finding of a saved weekly report. search_console: a saved Search Console opportunity."
},
"check_id": {
"type": "string",
"description": "Weekly finding type, or opportunity for Search Console. Required for check; absent for full."
},
"language": {
"enum": [
"en",
"pt"
],
"type": "string",
"description": "Language of the prompt instructions and check names: en for English, pt for Portuguese."
},
"report_id": {
"type": "string",
"description": "Required for weekly: saved report ID."
},
"request_id": {
"type": "string",
"format": "uuid",
"description": "New UUID v4 per generation. Keep it unchanged for retries."
},
"guest_token": {
"type": "string"
}
}
}