Skip to content

docs: add flow-series cross-promo + Ko-fi support link #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
imsankz merged 2 commits into from
Aug 30, 2026
Merged

docs: add flow-series cross-promo + Ko-fi support link #2

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
65fa444
docs(readme): accurate agent/provider counts, add TOC, GEO/AEO + alte…
imsankz Aug 26, 2026
521487d
docs: add flow-series cross-promo + Ko-fi support link
imsankz Aug 30, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 42 additions & 9 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,17 +6,38 @@
[![NPM](https://img.shields.io/npm/v/seoflow?label=seoflow)](https://www.npmjs.com/package/seoflow)
[![Node](https://img.shields.io/badge/node-%E2%89%A518-green.svg)](./package.json)

**Portable, AI-powered SEO pipeline for any content site.** Drop it into any project, point it at your posts, and get automated frontmatter fixes, internal link injection, image enrichment, AI content audits, fact-checking, and a self-learning priority system that gets smarter every run.

> Built for content teams who want programmatic SEO without vendor lock-in. Works with Next.js, Hugo, Jekyll, Astro, 11ty, WordPress, or any MDX/Markdown setup.
**Portable, AI-powered SEO pipeline for any content site.** Drop it into any project, point it at your posts, and get automated frontmatter fixes, internal link injection, image enrichment, AI content audits, fact-checking, GEO/AEO citations, and a self-learning priority system that gets smarter every run.

> Programmatic SEO without the SaaS lock-in. Works with Next.js, Hugo, Jekyll, Astro, 11ty, WordPress, or any MDX/Markdown stack. **Surfer / Clearscope / MarketMuse alternative** that lives in your repo.

## Table of Contents

- [Why SeoFlow?](#why-seoflow)
- [Quick Start](#quick-start) — [Zero-setup URL audit](#try-it-with-zero-setup-url-audit) · [One-liner install](#full-pipeline-install-one-liner) · [npm install](#via-npm-recommended) · [Dev clone](#from-this-repo-development)
- [Commands](#commands)
- [What It Does (12 Pipeline Steps)](#what-it-does-12-pipeline-steps)
- [SEO Agents (19 interactive agents)](#seo-agents-19-interactive-agents)
- [GSC Data](#gsc-data-live--csv-fallback)
- [Content Format Support](#content-format-support)
- [Voice & Domain](#voice--domain--make-it-yours)
- [AI Cost Guardrails](#ai-cost-guardrails)
- [Non-Travel Sites](#non-travel-sites--zero-code-changes)
- [Learning Data Portability](#learning-data-portability)
- [Brain Vault](#brain-vault)
- [Optional Extensions](#optional-extensions)
- [Testing](#testing)
- [Architecture](#architecture--what-belongs-where)
- [Requirements](#requirements)
- [Contributing](#contributing)
- [License](#license)

---

## Why SeoFlow?

- **Lives in your repo, not a SaaS dashboard.** No login, no per-seat pricing, no lock-in. Your content and your secrets stay on your machine.
- **20+ AI agents across every SEO discipline.** Technical, content, schema, local, GEO, drift, backlinks, programmatic, image-gen — installed into whichever AI coding tool you already use.
- **6 LLM providers with auto-fallback.** Gemini, OpenRouter, Anthropic, Claude CLI, Codex CLI, Gemini CLI. Set one key, it just works.
- **19 AI agents across every SEO discipline.** Technical, content, schema, local, GEO, drift, backlinks, programmatic, image-gen, llms-txt — installed into whichever AI coding tool you already use.
- **7 LLM providers with auto-fallback.** Gemini 2.5 Flash, OpenRouter, Anthropic, OpenAI-compatible endpoints (LM Studio, vLLM, Ollama), Claude CLI, Codex CLI, Gemini CLI. Set one key, it just works.
- **Self-learning priority system.** Records what actually moved the needle on GSC and re-ranks the next run so you always work on the highest-leverage post.
- **Graceful degradation.** No Ahrefs key? No NeuronWriter? No Pexels? SeoFlow silently skips that step and keeps going — it never crashes because a key is missing.
- **One-command URL audit.** `npx seoflow audit https://yoursite.com` — works with zero API keys and zero configuration.
Expand All @@ -43,7 +64,7 @@ You'll get a health score, missing-meta signals, schema check, link structure, a
bash <(curl -s https://raw.githubusercontent.com/imsankz/seoflow/main/install.sh)
```

This auto-detects your AI coding tool (Kiro, Claude Code, Cursor, Copilot, Windsurf, OpenCode, Codex, Cline, Lingma, Zed) and copies the right agents to the right folder. Then:
This auto-detects your AI coding tool (Kiro, Claude Code, Cursor, Copilot, Windsurf, OpenCode, Codex, Cline, Lingma, Zed, Amp) and copies the right agents to the right folder. Then:

```bash
npx seoflow init # interactive: creates seoflow.config.json
Expand Down Expand Up @@ -136,7 +157,7 @@ Each step runs through the orchestrator with dependency resolution, brain vault

---

## SEO Agents (20+ interactive agents)
## SEO Agents (19 interactive agents)

After install, agents are available in your AI tool. Example commands:

Expand Down Expand Up @@ -311,7 +332,7 @@ Available: ahrefs, bing-webmaster, dataforseo, firecrawl, profound, seranking, u
## Testing

```bash
npm test # All tests (unit + integration) — 50 tests
npm test # All tests (unit + integration)
npm run test:unit # Unit tests only (no file I/O)
npm run test:integration # Integration tests only
```
Expand Down Expand Up @@ -440,10 +461,22 @@ Please read our [Code of Conduct](./CODE_OF_CONDUCT.md). Security issues: see [S

---

## Related: the *flow* series

SeoFlow is part of a trio of zero-cost CLI tools — all MIT, all npm-published, all built on the same idea (free engines + your own AI agent as the smart layer):

| Tool | Job | Repo |
|---|---|---|
| **[SECflow](https://github.com/imsankz/SECflow)** | Security scanning for AI-driven repos (secrets, deps, custom rules) | github.com/imsankz/SECflow |
| **SeoFlow** | AI-powered SEO pipeline (audit, internal links, content gen, GSC) | github.com/imsankz/seoflow |
| **[LinkFlow](https://github.com/imsankz/linkflow)** | Backlink & directory submission automation (1,123 directories, Playwright, $0) | github.com/imsankz/linkflow |

**Use them together:** SeoFlow audits and improves your content → LinkFlow submits your product to directories that boost DR → SECflow keeps your repos clean while you ship. All three work with the same OmniRoute / OpenAI-compatible AI endpoint.

## Star / Share

If SeoFlow helps you ship better SEO content, ⭐ the repo and share it:

> **SeoFlow** — the AI SEO pipeline that lives in your repo, not a SaaS dashboard. `npx seoflow init` → audit → learn → grow. Works with any stack. https://github.com/imsankz/seoflow

Built by [@imsankz](https://github.com/imsankz).
Built by [@imsankz](https://github.com/imsankz). SeoFlow is free forever — if it saves you a Surfer/Clearscope bill, [buy me a coffee](https://ko-fi.com/chasingwhereabouts) ☕.
Loading