v0.2.3 — works out of the box (URL audit from npm, no double-runs)

v0.2.3 — the "works out of the box" release

Three fixes that make SeoFlow actually work for strangers installing from npm:

Fixed

• URL audit now works from the npm-installed CLI. The published package has no python/ dir, so npx @imsankz/seoflow audit <url> silently fell back to HEAD-only signals — empty title/H1/schema/link analysis for every user, always. Added a pure-Node fetch fallback (Node 18+ fetch + built-in parser). Zero Python deps, real signals. Verified from the packed tarball: Title: Example Domain, H1s: 1, schema/link checks all live.
• Double pipeline execution via the published CLI. esbuild bundles run.ts into dist/bin/cli.js, so the import.meta.url auto-run guard always matched inside the bundle and ran the whole pipeline twice — duplicate reports, duplicate brain writes, double AI calls. Auto-run now keys on the entry filename only. Verified: 1 run, 1 report.
• Clean Gemini CLI auth failures. Token-level auth errors (stale/ineligible credentials) now print one clear hint per run instead of dumping raw stderr mid-run; the fallback chain takes over silently.

Try it

npx @imsankz/seoflow audit https://yoursite.com

Zero config, zero API keys. The canonical short name npx seoflow goes live with the next npm publish (dual-publish script included — npm run publish:both).

v0.2.2 — GEO audit mode, content templates, reciprocal links

What's new since v0.1.0

SeoFlow has shipped 4 releases since launch — this release syncs the GitHub release page with the npm package (0.2.2).

v0.2.2 — GEO / AI-citability audit

• seoflow audit --mode geo — scores every post 0–100 on how likely AI answer engines (ChatGPT, Claude, Gemini, Perplexity, AI Overviews) are to cite it: answer-first openings, question-form headings, FAQ blocks, list/table density, AI-sounding phrase detection. Read-only scoring, no rewrites.

v0.2.1 — content engine & linking

• 12 rich content-type templates for seoflow generate (city-pass-review, things-to-do, day-trips, budget-guide, transportation…)
• Gap-queue-aware generation — auto-picks the next unwritten topic from your gap queue, ordered by priority × ROI
• Auto post-processing — new posts automatically run the full audit pipeline + reciprocal inbound linking (--no-audit to skip)
• Affiliate link injection — keyword-triggered, capped at 3/post
• Reciprocal internal linking — new posts get 2–4 backlinks injected from topically-related existing posts
• ImageKit CDN upload — Pexels/Unsplash images re-uploaded to your own CDN instead of hotlinked
• Orchestrator pipeline (seoflow orchestrate <slug>) with dependency resolution
• Brain vault (seoflow brain / vault) — lightweight cross-session working memory
• Research command — vault-backed research log so topics are never re-researched
• Live GSC via Google ADC (CSV fallback auto-detects EN/DE)

Also in this release

• Clean Gemini CLI auth failure handling — one clear hint instead of raw stderr dumps
• Build-safe frontmatter round-trips + configurable schema injection
• schema author/date/@id resolution + sc-domain: GSC properties
• README: fixed the zero-setup demo command (works via npx @imsankz/seoflow audit)

Install

npm install -D @imsankz/seoflow
# or full pipeline + AI agents:
bash <(curl -s https://raw.githubusercontent.com/imsankz/seoflow/main/install.sh)

Try it with zero keys: npx @imsankz/seoflow audit https://yoursite.com

v0.1.0 — SeoFlow open-source launch

SeoFlow v0.1.0 — the AI SEO pipeline that lives in your repo, not a SaaS dashboard.

Highlights

• 12-step pipeline — keywords, meta, links, images, neuron, content, review, schema, quality, technical, fact-check, report
• 20+ interactive SEO agents auto-installed into Kiro, Claude Code, Cursor, Copilot, Windsurf, OpenCode, Codex, Cline, Lingma, Zed
• 6 LLM providers with auto-fallback — Gemini, OpenRouter, Anthropic, Claude CLI, Codex CLI, Gemini CLI
• Self-learning priority system — records what actually moved the needle on GSC and re-ranks the next run
• Graceful degradation — never crashes because a key is missing; silently skips that step
• One-command URL audit — npx seoflow audit https://yoursite.com works with zero API keys
• Brain vault — working memory and cross-session audit trail saved to .seoflow/brain/
• Optional extensions — ahrefs, dataforseo, firecrawl, unlighthouse, banana (image-gen), and more

Install

bash <(curl -s https://raw.githubusercontent.com/imsankz/seoflow/main/install.sh)
npx seoflow init
npx seoflow status

Verification

• Build: clean (npm run build)
• Tests: 50/50 passing (npm test)
• CI: GitHub Actions (Node 20, build + test on push/PR to main)

See CHANGELOG.md for the full changelog.