Diff two pages for citation-worthiness
diff_pagesCompare two URLs to determine which is more likely to be cited by AI, with a dimension-by-dimension breakdown and prioritized fix recommendations for your page.
Instructions
Compare two URLs for AI citation-worthiness and return a structured breakdown of which page is more likely to be cited and why. Typical use: your page (url_a) vs a competitor's page (url_b).
Read-only. Runs audit_page on both URLs in parallel (2 HTTP fetches per URL), then diffs dimension_scores and findings. No new fetch logic beyond what audit_page already does.
Deterministic, rule-based; no LLM calls. Same two URLs return the same comparison on repeated runs.
When to use: competitive gap analysis - understand exactly which dimensions (schema, structure, robots, entity density, freshness, technical, authority, sitemap) put a competitor ahead, and get prioritized fix_recommendations_for_a to close the gap. For a single-URL audit, use audit_page. For overall scoring of one page, use score_citation_worthiness.
Capped at 2 URLs per call. Heuristic verdict - does not claim to know what AI assistants actually cite; verdict matches audit_page's existing rubric.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Optional target search query both pages are competing for (e.g. 'how to connect Zapier to Notion'). When provided, it is surfaced in fix_recommendations_for_a as context. Does not alter the scoring algorithm - scoring is based on audit_page's existing rubric. | |
| url_a | Yes | First URL to compare - typically your own page. Must be a fully-qualified http(s) URL that returns HTTP 200 (redirects are followed). | |
| url_b | Yes | Second URL to compare - typically a competitor's page. Must be a fully-qualified http(s) URL that returns HTTP 200 (redirects are followed). | |
| respect_robots | No | If true (default), respect robots.txt before fetching each URL. Set false only when auditing your own sites where you have intentionally blocked crawlers. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| delta | Yes | ||
| query | Yes | ||
| url_a | Yes | ||
| url_b | Yes | ||
| scores | Yes | ||
| missing_in_a | Yes | ||
| missing_in_b | Yes | ||
| better_for_citation | Yes | ||
| fix_recommendations_for_a | Yes |