What it does
SEO and sharing report for one site: what search engines and link previews (X, LinkedIn, WhatsApp, Slack) get from each page, and what to improve. It renders each page as visitors get it and checks: search (indexing, robots.txt, sitemap.xml, title and description per page, canonical, viewport, lang), sharing (own share image vs the Pagehive card, image format, size and shape for large previews, og and twitter tags), structure (one h1, heading order, image alt text, broken same-site links, pages nothing links to, redirects that lead to a 404 or another redirect, structured data, own icon) and weight (heavy HTML, images over 1 MB). findings have check, group (search, sharing, structure, weight), severity high/medium/low/info, title, detail, where, evidence and a fix (a tool and how). A private site is checked as if it were public. draft true checks the draft instead of the live version; a site never published is always checked from its draft. Share images on other websites are not fetched. max_seo_scan_pages per scan is a tier setting; pages past it are counted, not checked. 10 scans per site per hour. The last report shows on the site's SEO tab in /hive. Not for a site shared with you.
Plans
Works on every plan: Free, Basic, Pro and Ultra.
Parameters
| Name | Type | About |
|---|---|---|
site_idrequired | string | The id of the site. list_sites gives the ids of your sites. |
draft | boolean | true checks the draft instead of the live version. |
Example
Call seo_scan with these arguments:
{
"site_id": "01a1…"
}
Ids like 01a1… stand for your own. list_sites and list_tables give you the real ones.
Related guides
- Run an SEO scanSee what search engines and link previews get.
- Link previews and site iconControl how a link looks on X, Slack and WhatsApp.