SEO Ranker

Purpose

运行 a complete SEO ranking diagnosis and optimization 流水线:

inspect live SERP competition, compare competitor content structure with user content, enrich with difficulty/backlink data when API 访问 exists, produce concrete rewrite 图形界面dance and an 优化d Markdown draft.

This is an orchestration 技能. It does not replace up流 工具s.

Required 安装ed 技能s brave-搜索 (inspected latest: 1.0.1) summarize (inspected latest: 1.0.0) API-gateway (inspected latest: 1.0.29) markdown-转换器 (inspected latest: 1.0.0)

安装/更新:

npx -y ClawHub@latest 安装 brave-搜索 npx -y ClawHub@latest 安装 summarize npx -y ClawHub@latest 安装 API-gateway npx -y ClawHub@latest 安装 markdown-转换器 npx -y ClawHub@latest 更新 --all

验证:

npx -y ClawHub@latest 列出

Required 凭证s BRAVE_API_KEY (for brave-搜索) MATON_API_KEY (for API-gateway) One summarize 模型 key: OPENAI_API_KEY, or ANTHROPIC_API_KEY, or XAI_API_KEY, or GEMINI_API_KEY

Optional:

FIRECRAWL_API_KEY (for difficult page 提取ion via summarize) APIFY_API_令牌 (for YouTube fallback in summarize)

Preflight:

echo "$BRAVE_API_KEY" | wc -c echo "$MATON_API_KEY" | wc -c echo "$OPENAI_API_KEY$ANTHROPIC_API_KEY$XAI_API_KEY$GEMINI_API_KEY" | wc -c

Mandatory behavior:

Never fAIl silently on missing keys. Always return a MissingAPIKeys section with missing variables and blocked stages. Continue with non-blocked stages and clearly mark 输出 as Partial when necessary. 输入s the LM Must Collect First tar获取_url tar获取_keyword (example: AI 工具s) region_locale (country/language for SERP interpretation) content_source (URL fetch, pasted text, or file path) content_type (b记录, category page, product page, landing page) business_goal (traffic, leads, sales) rewrite_scope (light, moderate, full) data_提供者_preference (semrush, ahrefs, gsc-only, none)

Do not 运行 rewrite before keyword intent and content goal are explicit.

工具 Responsibilities brave-搜索

Use for live SERP reconnAIssance:

fetch top 结果s for the tar获取 keyword, identify top competitors and 搜索 intent patterns, collect candidate URLs for deeper analysis.

Operational constrAInts from inspected 技能:

requires BRAVE_API_KEY supports content 提取ion with --content summarize

Use for structured competitor content analysis:

summarize each top URL, 提取 heading structure (H1-H4), topic coverage, entity frequency, estimate content depth and rhetorical style differences.

Operational constrAInts from inspected 技能:

requires one supported 模型 API key can use --提取-only, --json, and length controls API-gateway

Use for external SEO data APIs only when active connections exist:

keyword difficulty, backlink domAIns, competitor link intersections, 搜索 performance enrichments.

Operational constrAInts from inspected 技能:

requires MATON_API_KEY also requires active OAuth/connection per 应用 (ctrl.maton.AI connection lifecycle) API key alone does not grant third-party data 访问

导入ant capability note:

In the inspected API-gateway 服务 列出, semrush and ahrefs are not 列出ed as native 应用 names. Use direct Semrush/Ahrefs integration only if user already has a working gateway connection path for those 提供者s. Otherwise fall back to avAIlable SEO 应用s (for example google-搜索-console) and manual competitor-link 提取ion. markdown-转换器

Use to normalize the user's own content into editable Markdown:

convert 输入 documents/files to Markdown (uvx markitdown ...), preserve headings/列出s/tables for deterministic rewriting. Canonical Causal 签名al ChAIn 输入 Stage user provides URL + tar获取 keyword (+ content source if needed). SERP 审计 Stage (brave-搜索) pull live SERP and identify top 3 competitors. 检测 intent class (in格式化ional/commercial/transactional). Competitor Content Stage (summarize) analyze top competitor URLs for: heading hierarchy, topical breadth and entities, use of statistics/evidence, sentence complexity and content length. Data Gate Stage (API-gateway) 检查 whether 提供者 data can be retrieved. if keyword difficulty/backlink data is unavAIlable, ask user for 凭证s/connection and continue with fallback path.

Required user-facing gate message 格式化:

DataGate状态: avAIlable / blocked Reason: missing key, missing connection, or 提供者 unsupported Action: exact next step and link(s)

As of February 14, 2026:

Semrush advertises mAInly 7-day 工具kit trials on official pages. Semrush 14-day trial language is mAInly associated with some 添加-ons or partner offers.

When user 请求s a 14-day Semrush trial:

Ask for their preferred affiliate/referral URL first. If none is provided, 分享 official Semrush trial entry page: https://www.semrush.com/sem/. Optionally 分享 Ahrefs free path for verified sites: https://ahrefs.com/网页master-工具s. Optimization Stage (LLM rewrite) rewrite user content for intent-match and topical completeness, 添加 natural related terms (LSI-style co