1. 專案概覽
OpenSEO 是一套開源、按用量計費的 SEO 工具組,定位為 Semrush 與 Ahrefs 的替代方案,涵蓋關鍵字研究、排名追蹤、競爭對手洞察、反向連結、網站稽核與 AI 能見度,並透過 MCP 伺服器與 Agent Skills 將同一批資料開放給 AI 代理使用。
2. 背景與定位
為何而生
市面上的成熟 SEO 套件通常以月費訂閱形式販售,這對只偶爾進行 SEO 分析的小型團隊、獨立開發者與代理商而言並不划算。OpenSEO 採取不同做法:你自備 DataForSEO API 金鑰,只為實際請求的資料付費。自行架設時,沒有席位授權費,也沒有固定訂閱費。
與類似專案的差異
- 按用量計費 — 資料由 DataForSEO 依每次請求計費,而非綁定月費方案。
- 開放且可分支 — 採 MIT 授權,介面刻意保持簡潔,圍繞聚焦的工作流程設計,方便自行客製。
- 為代理而生 — 內建 MCP 伺服器與可重複使用的 Agent Skills,讓 Claude Code、Codex、ChatGPT 等工具與其他代理能直接執行 SEO 任務。
- 架設方式彈性 — 可使用 openseo.so 的託管服務,或以 Cloudflare 或 Docker 自行架設。
3. 功能類別
🔎 關鍵字研究
發掘並評估搜尋詞及其潛力。目的:判斷哪些主題值得投入。
📈 排名追蹤
長期監控你的頁面在指定關鍵字下的排名。目的:衡量 SEO 工作的成效。
🕵️ 競爭對手洞察
檢視競爭網站靠哪些關鍵字取得排名。目的:找出缺口與機會。
🔗 反向連結
檢視指向某個網站的連結概況。目的:了解網站權威度與建立連結的機會。
🩺 網站稽核
爬取網站並找出技術面 SEO 問題。目的:找出並修正阻礙排名的問題。
🤖 AI 能見度
檢查品牌或網站在 AI 驅動的搜尋體驗中如何呈現。目的:在搜尋轉向 AI 答案時維持能見度。
🧩 代理整合
提供 MCP 伺服器、Agent Skills,以及 ChatGPT(網頁版與桌面版)、Codex 與 Claude Code 風格代理的設定指南。目的:讓 AI 代理能依據真實資料執行 SEO 工作流程。
4. 重點特色
- 用多少付多少 — 自備 DataForSEO 金鑰;自行架設的費用直接付給 DataForSEO。
- MCP 伺服器與 Agent Skills — 一步步引導代理完成 SEO 任務。
- Cloudflare 優先的自行架設 — 這是建議途徑,文件說明可在 Cloudflare 免費方案上運作。
- Docker 選項 — 提供
compose.yaml設定,最適合測試用途。 - 託管選項 — 可免費試用;託管訂閱方案定價為每月 10 美元,DataForSEO 請求另加 28% 加成。
- 現代 TypeScript 技術堆疊 — 採用 Vite、Cloudflare Wrangler、pnpm 與 Drizzle ORM,易於分支與擴充。
5. 依角色劃分的使用情境
- 一般開發者 — 將 SEO 資料加入自己的應用程式,或分支介面以打造自訂工作流程。
- DevOps/SRE — 在 Cloudflare 或 Docker 上自行架設,並透過環境設定管理金鑰。
- 資料/研究科學家 — 取得關鍵字、排名與反向連結資料進行分析,或透過代理查詢。
- 專案經理與行銷人員 — 追蹤排名、稽核網站並比較競爭對手,無需固定訂閱。
6. 開始使用
找到你需要的內容
- 託管應用程式與文件:openseo.so
- MCP 設定:https://openseo.so/docs/mcp
- Agent Skills 設定:https://openseo.so/docs/skills/setup
安裝/整合
自行架設指南位於儲存庫中:
git clone https://github.com/every-app/open-seo.git
cd open-seo
# Then follow one of:
# docs/SELF_HOSTING_CLOUDFLARE.md (recommended)
# docs/SELF_HOSTING_DOCKER.md (best for testing)
# docs/LOCAL_DEVELOPMENT.md (development)
# docs/DATAFORSEO_API_KEY.md (API key setup)
貢獻
清楚且撰寫良好的問題回報是最有用的貢獻。本專案提供一項技能來協助:
npx skills add every-app/open-seo --skill simple-issue-description
詳情請見 docs/CONTRIBUTING.md。
7. 專案結構
open-seo/
├── src/ # Application source
├── web/ # Web frontend
├── docs/ # Self-hosting, development and contributing guides
├── drizzle/ # Database migrations
├── deploy/ # Deployment configuration
├── plugins/openseo/# Plugin package for agent tools
├── scripts/ # Tooling scripts
├── specs/ # Specifications
├── tests/ # Tests
├── compose.yaml # Docker Compose setup
├── wrangler.jsonc # Cloudflare configuration
└── .env.example # Example environment variables
8. 相關生態系
- DataForSEO — 所有 SEO 資料的必要資料供應商。
- Cloudflare — 建議的自行架設平台(另也提及 Railway、Coolify 與 Dokploy)。
- 相容於 MCP 的代理 — Claude Code、Codex、ChatGPT、OpenClaw 與 Hermes。
- 商業對應產品 — Semrush 與 Ahrefs,OpenSEO 將自身定位為其替代方案。
9. 授權
- ✅ 可依 MIT 授權使用、修改、分支與再散布程式碼,包括商業用途
- ✅ 可為個人、團隊或客戶工作自行架設
- ❌ 作者不提供任何保證,亦不承擔任何責任
- ℹ️ 副本中須保留著作權與授權聲明
- ℹ️ SEO 資料來自 DataForSEO,其有自身的定價與條款
10. 常見問題
問:我需要訂閱嗎?
答:自行架設時不需要。你直接依用量付費給 DataForSEO。託管版本可免費試用,付費方案定價為每月 10 美元。
問:我應該在哪裡自行架設?
答:建議使用 Cloudflare(見 docs/SELF_HOSTING_CLOUDFLARE.md)。Docker 最適合測試(docs/SELF_HOSTING_DOCKER.md)。
問:AI 代理可以使用它嗎?
答:可以。請見 MCP 指南 與 Agent Skills 指南。
問:如何取得 DataForSEO 金鑰?
答:請依照儲存庫中的 docs/DATAFORSEO_API_KEY.md 操作。
問:我可以如何貢獻?
答:提出清楚的問題回報;simple-issue-description 技能可協助你撰寫。
11. 快速連結
- 儲存庫:https://github.com/every-app/open-seo
- 網站/託管服務:https://openseo.so
- 定價:https://openseo.so/pricing
- 問題回報:https://github.com/every-app/open-seo/issues
- 社群:https://discord.gg/c9uGs3cFXr
12. 總結
OpenSEO 將商業 SEO 套件的核心工作流程帶入一個 MIT 授權、按用量計價且可分支的專案,並讓 AI 代理得以取用這些資料。它適合想要取得 SEO 洞察、又不想背負固定月費的開發者、小型團隊、代理商與行銷人員。