shadowresearch/auto-geo doctor
Audit URLs for AI-search / GEO citation-readiness on every pull request. Posts a sticky comment with per-URL scores out of 8 across TL;DR, question H2s, Article + FAQPage JSON-LD, entity density, image cadence, answer-first lede, and self-link signals. Powered by auto-geo by Shadow.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Stale
- License
- None
Inputs
| name | description | required | default |
|---|---|---|---|
| urls | Newline-separated list of URLs to audit. Mutually exclusive with `sitemap`. | no | "" |
| sitemap | Sitemap URL whose `<loc>` entries will be audited. Mutually exclusive with `urls`. | no | "" |
| github-token | Token used to post / update the sticky PR comment. Defaults to the ephemeral GITHUB_TOKEN of the running job. | no | ${{ github.token }} |
| threshold | Minimum passing score (0-8). Any URL below this threshold causes the action to exit 1. | no | 6 |
| max-pages | Cap on URLs audited when expanding a sitemap. Ignored when `urls` is used. | no | 50 |
| concurrency | Maximum parallel `auto-geo doctor` invocations. | no | 3 |
| comment-tag | HTML-comment marker used to find and update the sticky PR comment across re-runs. | no | auto-geo-doctor |
| fail-on-regression | When `true`, exit nonzero if any URL scored worse than its most-recent previous run on this PR. | no | false |
Outputs
| name | description |
|---|---|
| score-summary | Human-readable summary in the shape `7/8 avg, N URLs`. |
| report-json | Path to the aggregated JSON report uploaded as a workflow artifact. |