gbessoni/seobuild-onpage
254 stars · Last commit 2026-09-03
SEOBuild Onpage - The first AI agent that writes pages Google ranks AND LLMs cite. One command in, ranking page out. Built on DeerFlow, powered by 2026 SEO + GEO strategies tested / working. Forensic competitive analysis, 500-token chunk architecture, entity consensus, verification tags. BYOK GSC, DataforSEO. Works w/ OpenClaw, Claude Code, Codex
README preview
# seobuild-onpage v2.4.0 ### One command. Competitive data in. Ranking pages out. ```bash git clone https://github.com/gbessoni/seobuild-onpage.git ~/.claude/skills/seobuild-onpage ``` Most SEO tools tell you what's wrong with your site. This one writes the pages. `/seoagi "airport parking JFK"` pulls the current SERP, analyzes what's ranking, finds the gaps in their content, and writes you a complete page -- with the heading structure, depth, FAQ section, and schema markup that actually competes. Not thin content. Not keyword-stuffed filler. Pages backed by live data from the tools the pros use. **New in v2.4.0 -- Discovery Routes & Off-Page Embeds:** - **The Anti-Hallucination Meta-Directive** -- a new MASTER RULE at the top of SKILL.md. LLMs are trained on fifteen years of largely obsolete SEO writing, so the agent is now explicitly forbidden from applying pre-trained SEO instincts (LSI keywords, keyword density, blog hubs, "write 2,000 words") and must execute only the rules in the document. Includes a table of the specific instincts to suppress and why each is wrong. - **GSC Discovery Route Fill** -- find URLs Google already expects to exist and fill them. `gsc_pull.py --ghost-paths` finds pages earning impressions that return 404, which is the highest-confidence signal available through the API. `--crawl-stats-csv` ingests a manual Crawl Stats export for the literal Discovery list, because that report is UI-only and not in the Search Console API. - **Unlinked Brand Citations** -- Tier 1 off-page drafts now carry plain-text brand and URL mentions alongside HTML links. RAG pipelines read plain text, so this adds retrieval coverage anchor-only linking misses. - **Off-Page Embeds** -- Tier 1 drafts embed a live artifact pointing at the money entity where the platform allows it, defaulting to the officially supported Google Maps embed. Conditional by design, since most Tier 1 platforms block arbitrary iframes. - **Strict SSR/SSG Requirement** -- client-side-rendered SPAs are banned as an output target. Every internal link must exist in the raw HTML DOM of the initial server response, because JS-injected link graphs are routinely missed or crawled late. - **66-point quality checklist** -- adds Off-Page Embed, Unlinked Citation, and SSR/SSG Validation. Passing threshold raised to 57/66.