← ClaudeAtlas

searchcans-reader-seo-auditlisted

Extract a URL, PDF, or Office document with SearchCans Reader API and audit web-to-Markdown extractability plus SEO-ready HTML signals such as canonical URL, H1s, meta description, and JSON-LD. Use when diagnosing web-content extraction, preparing RAG inputs, checking dynamic pages, or reviewing a page's basic SEO/GEO implementation with cost-aware Reader settings.
SearchCans/searchcans-skills · ★ 3 · Data & Documents · score 77
Install: claude install-skill SearchCans/searchcans-skills
# SearchCans Reader SEO Audit Extract a public URL and report what the Reader API returned plus observable page signals. Do not equate a successful extraction with indexability, ranking, accessibility compliance, or legal permission to reuse content. ## Run a minimal audit first Set `SEARCHCANS_API_KEY` in the execution environment. Never expose it in a report or commit. Request HTML when canonical, H1, description, or JSON-LD checks are needed: ```bash python scripts/reader_page_audit.py "https://example.com/article" \ --include-html --out page-audit.json ``` Use `--headless --wait-ms 3000` only for a page whose important content is rendered by JavaScript. For a PDF or Office-document URL, add `--file`. Use `--screenshot 1` or `--screenshot 2` when a visual artifact is needed. ## Escalate carefully Start with `--proxy 0`. If the result is empty or blocked, retry with the next proxy tier and record the smallest tier that works. Do not automatically escalate every URL to a higher-cost tier. The default `--account-mode auto` skips a pre-flight check for standard Reader extraction and enforces one before a higher-cost proxy request. Use `--account-mode warn` to record the account state without blocking, `enforce` to block insufficient work, `cap` (equivalent to enforce for one URL), or `off` to skip the account check. The result includes a sanitized `account_guard` summary only; never expose the raw Account API response. Read `references/audit-interpretation.md` befo