SEO Intel — 競爭性 SEO 智慧是做什麼的？

您是 SEO Intel 助手。協助使用者設定、執行並解讀使用 SEO Intel CLI 工具的競爭性 SEO 分析。

SEO Intel 的功能

SEO Intel 爬取使用者的網站及競爭對手，使用本地 AI（Ollama/Qwen — 免費、裝置端）提取結構化與語意訊號，然後使用雲端 LLM（Gemini/Claude/GPT — 使用者自有金鑰）進行差距分析。

流程：

Crawl (Playwright) → Extract (Qwen via Ollama) → Analyze (cloud LLM) → Dashboard (HTML/Chart.js)

所有資料皆保留在本地。 無遙測、無雲端同步。採用磁碟上的 SQLite 資料庫。

安裝檢查

npm 套件： https://www.npmjs.com/package/seo-intel

npm install -g seo-intel

工具位於 ~/.openclaw/skills/froggo-seo-intel/seo-intel/。

1. 檢查是否已安裝：

test -d ~/.openclaw/skills/froggo-seo-intel/seo-intel/node_modules && echo "installed" || echo "not-installed"

2. 若未安裝：

cd ~/.openclaw/skills/froggo-seo-intel/seo-intel && npm install && npx playwright install chromium --with-deps

3. 檢查 Ollama：

curl -s http://localhost:11434/api/tags 2>/dev/null | head -1

若正在執行，請確認有可用的 Qwen 模型。若缺少，請執行：

ollama pull qwen3.5:9b

4. 檢查 API 金鑰（analyze 指令至少需要一個）：請在 .env 中尋找 GEMINI_API_KEY、ANTHROPIC_API_KEY 或 OPENAI_API_KEY。

5. 網路精靈（建議首次設定使用）：

cd ~/.openclaw/skills/froggo-seo-intel/seo-intel && node cli.js setup-web

接著在瀏覽器中開啟 http://localhost:3000/setup。

CLI 指令

所有指令皆從 SEO Intel 安裝目錄執行：

cd ~/.openclaw/skills/froggo-seo-intel/seo-intel

免費方案

指令	說明
`node cli.js setup`	互動式 CLI 精靈 — 設定專案、API 金鑰、Ollama
`node cli.js setup-web`	基於網頁的 6 步驟精靈（建議首次執行）
`node cli.js crawl <project>`	爬取目標網站及所有已設定的競爭對手
`node cli.js crawl <project> --domain example.com`	僅爬取單一網域
`node cli.js crawl <project> --stealth`	隱形模式（偽造 Chrome 指紋，繞過機器人封鎖）
`node cli.js status`	顯示爬取新鮮度、提取覆蓋率、授權資訊
`node cli.js report <project>`	在終端機列印最新的分析摘要
`node cli.js html`	產生所有專案的 HTML 儀表板（自動開啟瀏覽器）
`node cli.js serve`	在連接埠 3000 啟動儀表板伺服器（自動開啟瀏覽器）
`node cli.js competitors <project>`	列出已設定的競爭對手
`node cli.js competitors <project> --add domain.com`	新增競爭對手
`node cli.js competitors <project> --remove domain.com`	移除競爭對手
`node cli.js schemas <project>`	Schema.org 覆蓋率分析
`node cli.js export <project>`	以 JSON/CSV 格式匯出爬取資料，供任何 AI 使用
`node cli.js guide <project>`	列印 7 個章節 — 隨時掌握當前進度
`node cli.js subdomains <domain>`	透過 crt.sh + DNS 探索子網域
`node cli.js update`	檢查更新

Solo 方案（€19.99/月或 €199/年）

指令	說明
`node cli.js extract <project>`	對已爬取頁面進行 AI 提取（Ollama/Qwen，本地）
`node cli.js extract <project> --stealth`	隱形提取回填（針對失敗的頁面）
`node cli.js analyze <project>`	透過雲端 LLM 進行完整的競爭差距分析
`node cli.js keywords <project>`	關鍵字差距矩陣 + 機會尋找器
`node cli.js run`	智慧 Cron：爬取下一個過期網域、依需分析、結束
`node cli.js brief <project>`	每週 SEO 摘要 — 變更內容、新差距、勝利與行動
`node cli.js export-actions <project>`	按技術/競爭/建議優先排序的行動清單
`node cli.js competitive-actions <project>`	`export-actions --scope competitive` 的捷徑
`node cli.js suggest-usecases <project>`	從競爭對手模式中建議缺少的頁面/使用案例
`node cli.js velocity <project>`	內容發布速度追蹤器
`node cli.js shallow <project>`	找出可超越的競爭對手「薄弱冠軍」頁面
`node cli.js decay <project>`	找出失去新鮮度的過期競爭對手內容
`node cli.js headings-audit <project>`	H1-H6 標題結構分析
`node cli.js orphans <project>`	孤立實體 — 被提及但無專屬頁面
`node cli.js entities <project>`	實體覆蓋差距分析
`node cli.js friction <project>`	轉換摩擦偵測
`node cli.js schemas-backfill <project>`	為已爬取頁面回填 JSON-LD 結構化資料
`node cli.js js-delta <project>`	JS 渲染 vs 原始 HTML 比較
`node cli.js auth`	顯示 API 金鑰 + OAuth 狀態
`node cli.js auth google`	透過 OAuth 連接 Google Search Console

爬取模式矩陣

指令	發現頁面	提取	隱形
`crawl`	✅	✅	❌ 誠實機器人
`crawl --stealth`	✅	✅	✅ 偽造 Chrome
`extract`	❌	✅ 回填	❌ 誠實機器人
`extract --stealth`	❌	✅ 回填	✅ 持久性會話

若網站封鎖機器人，請使用 crawl --stealth。它能一次處理所有作業。

專案設定

專案設定在 config/<project>.json 中：

{
  "project": "myproject",
  "context": {
    "siteName": "My Site",
    "url": "https://example.com",
    "industry": "SaaS / DevTools",
    "audience": "Solana 開發者",
    "goal": "在 RPC 與交易 API 關鍵字上超越競爭對手"
  },
  "target": {
    "domain": "example.com",
    "maxPages": 200,
    "crawlMode": "standard"
  },
  "competitors": [
    { "domain": "competitor1.com", "maxPages": 100 },
    { "domain": "competitor2.com", "maxPages": 100 }
  ]
}

可透過精靈（node cli.js setup）或手動建立。進階方案支援多個專案。

模型設定

提取（本地、免費 — Ollama）

在安裝目錄編輯 .env：

OLLAMA_URL=http://localhost:11434
OLLAMA_MODEL=qwen3.5:9b        # 建議
OLLAMA_CTX=16384

依 VRAM 的模型建議：

3–4 GB VRAM → qwen3.5:4b
6–8 GB VRAM → qwen3.5:9b（建議）
16+ GB VRAM → qwen3.5:27b
僅 CPU → qwen3:4b（較慢但仍可運作）

您也可以將提取指向遠端 Ollama 實例：

OLLAMA_URL=http://192.168.0.190:11434   # 例如，搭載 GPU 的家庭伺服器

分析（雲端，需要 API 金鑰）

請在 .env 中至少加入一個：

GEMINI_API_KEY=your-key          # 建議（約 $0.01/次）
ANTHROPIC_API_KEY=your-key       # 品質最高
OPENAI_API_KEY=your-key          # 全面穩定
DEEPSEEK_API_KEY=your-key        # 經濟實惠

授權

SEO_INTEL_LICENSE=SI-xxxx-xxxx-xxxx-xxxx

在 https://froggo.pro/seo-intel 取得金鑰。

資料庫架構

SEO Intel 使用本機 SQLite 資料庫（seo-intel.db）。了解架構有助於解讀結果。

`domains`

追蹤所有爬取的網站。

id, domain, project, role ('target'|'competitor'), first_seen, last_crawled

`pages`

每個爬取的 URL 一行。

id, domain_id, url, crawled_at, status_code, word_count, load_ms,
is_indexable, click_depth, published_date, modified_date,
content_hash, first_seen_at

`extractions`

Qwen 提取的每頁語意資料。

id, page_id (unique), title, meta_desc, h1, product_type,
pricing_tier ('free'|'freemium'|'paid'|'enterprise'|'none'),
cta_primary, tech_stack (JSON array), schema_types (JSON array),
search_intent, primary_entities, extracted_at

`headings`

每頁的所有 H1–H6 標題。

id, page_id, level (1-6), text

`keywords`

在每頁找到的關鍵字及其位置上下文。

id, page_id, keyword, location ('title'|'h1'|'h2'|'meta'|'body'),
search_volume, keyword_difficulty

`links`

內部與外部連結。

id, source_id, target_url, anchor_text, is_internal (0|1)

`technical`

每頁的技術 SEO 訊號。

id, page_id (unique), has_canonical, has_og_tags, has_schema,
is_mobile_ok, has_sitemap, has_robots,
core_web_vitals (JSON: {lcp, cls, fid})

`page_schemas`

已解析的 JSON-LD 結構化資料。

id, page_id, schema_type ('@type' value: Organization/Product/Article/FAQ/etc.),
name, description, rating (aggregateRating.ratingValue),
rating_count, price, currency, author, date_published, date_modified,
image_url, raw_json (full object), extracted_at

`analyses`

儲存的雲端 LLM 分析結果。

id, project, generated_at, model, keyword_gaps (JSON), long_tails (JSON),
quick_wins (JSON), new_pages (JSON), content_gaps (JSON),
technical_gaps (JSON), positioning, raw

解讀結果

當使用者詢問 SEO 結果時：

檢查最新分析：reports/<project>-analysis-*.json
檢查 HTML 儀表板：reports/all-projects-dashboard.html
按影響力排序：
- 結構化資料差距（缺少 FAQPage、BreadcrumbList、Organization = 錯失 SERP 功能機會）
- 競爭對手涵蓋但缺少的主題（內容差距）
- 內容過於薄弱（已索引頁面 word_count < 300）
- 孤立頁面（無內部連結 = 零 PageRank 流動）
- 技術問題（缺少 canonical、OG 標籤、索引性問題）

典型使用者流程

「為我的網站設定 SEO Intel」 → 執行 node cli.js setup-web，協助設定網域 + API 金鑰，開啟 http://localhost:3000/setup

「爬取我的網站和競爭對手」 → node cli.js crawl <project> — 敘述進度，說明目前發現的內容

「我接下來該寫什麼？」 → node cli.js keywords <project> + node cli.js brief <project> — 摘要差距並推薦 2-3 個主題

「我與競爭對手相比如何？」 → node cli.js serve — 自動在瀏覽器中開啟所有專案儀表板，附帶即時控制項

「新增競爭對手」 → node cli.js competitors <project> --add domain.com，然後重新爬取該網域

「競爭對手阻擋了我的爬蟲」 → node cli.js crawl <project> --domain blocked.com --stealth

「提取中途失敗」 → node cli.js extract <project>（若原本是隱形爬取則加上 --stealth）

「更新 SEO Intel」 → node cli.js update --apply

故障排除

爬蟲被阻擋（403、429、空白頁面）

使用隱形模式：

node cli.js crawl <project> --domain blocked-site.com --stealth

隱形模式使用 Playwright 搭配偽造 Chrome 指紋並加入 2-5 秒的隨機延遲。

提取產生空白結果

檢查 Ollama 是否在執行：curl http://localhost:11434/api/tags
確認有可用的 Qwen 模型：ollama list
若模型在遠端機器上，請在 .env 中設定 OLLAMA_URL=http://<ip>:11434
執行回填：node cli.js extract <project>

`analyze` 指令失敗

檢查 .env 中是否設定 API 金鑰
檢查進階授權：node cli.js status — 顯示方案層級
嘗試不同提供者：在 .env 中加入另一個金鑰，SEO Intel 會使用任何現有的金鑰

資料庫錯誤 / 資料庫損毀

# 安全備份 + 重設
cp seo-intel.db seo-intel.db.bak-$(date +%s)
sqlite3 seo-intel.db "PRAGMA integrity_check"

若完整性檢查失敗，請從備份還原或重新爬取。

Node 版本過舊

SEO Intel 需要 Node.js 22.5+（使用內建 SQLite）。

node --version   # 必須為 22.5+
nvm install 22   # 或使用 nvm/fnm 進行升級

Playwright / Chromium 遺失

cd ~/.openclaw/skills/froggo-seo-intel/seo-intel
npx playwright install chromium --with-deps

HTML 儀表板未更新

請在每次新的爬取/分析後重新產生：

node cli.js html

這會產生所有專案儀表板並自動開啟。或者重新啟動 serve — 它會在每次造訪時重新產生。

代理式擴充備忘錄（規劃方向）

SEO Intel 正在超越靜態 SEO 報告，進化為代理式研究 + 執行基板。使用此技能的未來代理應思考三個層次：

1. 開發管線匯出

將分析結果視為下游執行代理的輸入。下一步是結構化匯出，將發現轉換為：

技術編輯建議
結構/導覽修正
頁面建立簡報
超越競爭對手的實作任務

目標輸出格式應同時具備：

機器可讀（JSON，適用於管線 / CI / 其他代理）
提示就緒（Markdown 摘要，適用於 Claude Code / Codex / Gemini）

2. 競爭行動匯出

儀表板和 SQLite 資料已包含足夠資訊來產生精簡的你 vs 競爭對手 → 行動清單。偏好能說明以下內容的匯出：

競爭對手擁有什麼
目標缺少什麼
為何重要
下一步應建立哪個頁面/編輯

這應以執行為優先，而非僅是描述性分析。

3. 建議性使用案例（重要）

本地爬取 + 提取資料庫不只是 SEO 報告的來源，更是建構者的一般情報層。代理應利用它來建議：

應建立的文件頁面
應改善的產品頁面
應建立的著陸頁面
應補齊的入門引導缺口
功能比較頁面
開發者信任頁面（速率限制、認證、安全性、變更日誌、快速入門）

以兩種形式實作：

CLI 介面（例如未來 suggest-usecases <project> 指令）
代理原生模式，讓強大的雲端模型直接查詢 SQLite 資料並從中推理

CLI 版本使功能可被發現並易於整合至管線。代理原生版本允許從相同的本地資料集進行更深度的開放式推理。

運作原則

請不要為每個情境建立一個僵固的掛鉤。反之，教導代理正確利用資料庫：

檢查競爭對手的文件/指南/參考覆蓋率
與目標覆蓋率比較
綜合出具體的頁面/建置/使用案例建議
匯出 ...

...（原文截斷）

在你喜歡的 AI 中提問

說明文件

SEO Intel — 競爭性 SEO 智慧 是做什麼的？

SEO Intel 的功能

安裝檢查

CLI 指令

免費方案

Solo 方案（€19.99/月 或 €199/年）

爬取模式矩陣

專案設定

模型設定

提取（本地、免費 — Ollama）

分析（雲端，需要 API 金鑰）

授權

資料庫架構

domains

pages

extractions

headings

keywords

links

technical

page_schemas

analyses

解讀結果

典型使用者流程

故障排除

爬蟲被阻擋（403、429、空白頁面）

提取產生空白結果

analyze 指令失敗

資料庫錯誤 / 資料庫損毀

Node 版本過舊

Playwright / Chromium 遺失

HTML 儀表板未更新

代理式擴充備忘錄（規劃方向）

1. 開發管線匯出

2. 競爭行動匯出

3. 建議性使用案例（重要）

運作原則

Individual skills in this repo

LeoYeAI/openclaw-master-skills

LeoYeAI/openclaw-master-skills

LeoYeAI/openclaw-master-skills

LeoYeAI/openclaw-master-skills

LeoYeAI/openclaw-master-skills

LeoYeAI/openclaw-master-skills

LeoYeAI/openclaw-master-skills

LeoYeAI/openclaw-master-skills

LeoYeAI/openclaw-master-skills

LeoYeAI/openclaw-master-skills

LeoYeAI/openclaw-master-skills

LeoYeAI/openclaw-master-skills

LeoYeAI/openclaw-master-skills

LeoYeAI/openclaw-master-skills

LeoYeAI/openclaw-master-skills

LeoYeAI/openclaw-master-skills

LeoYeAI/openclaw-master-skills

LeoYeAI/openclaw-master-skills

LeoYeAI/openclaw-master-skills

LeoYeAI/openclaw-master-skills

相關技能

steipete/sag

steipete/oracle

steipete/peekaboo

mattpocock/design-an-interface

mattpocock/prototype

mattpocock/grill-me

SEO Intel — 競爭性 SEO 智慧是做什麼的？

Solo 方案（€19.99/月或 €199/年）

`domains`

`pages`

`extractions`

`headings`

`keywords`

`links`

`technical`

`page_schemas`

`analyses`

`analyze` 指令失敗