{ "schemaVersion": "1.0", "item": { "slug": "seo-ranker", "name": "SEO Ranker", "source": "tencent", "type": "skill", "category": "数据分析", "sourceUrl": "https://clawhub.ai/h4gen/seo-ranker", "canonicalUrl": "https://clawhub.ai/h4gen/seo-ranker", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/seo-ranker", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=seo-ranker", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "SKILL.md", "references/inspected-skills.md" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-23T16:43:11.935Z", "expiresAt": "2026-04-30T16:43:11.935Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/seo-ranker" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/seo-ranker", "agentPageUrl": "https://openagent3.xyz/skills/seo-ranker/agent", "manifestUrl": "https://openagent3.xyz/skills/seo-ranker/agent.json", "briefUrl": "https://openagent3.xyz/skills/seo-ranker/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "Purpose", "body": "Run a complete SEO ranking diagnosis and optimization pipeline:\n\ninspect live SERP competition,\ncompare competitor content structure with user content,\nenrich with difficulty/backlink data when API access exists,\nproduce concrete rewrite guidance and an optimized Markdown draft.\n\nThis is an orchestration skill. It does not replace upstream tools." }, { "title": "Required Installed Skills", "body": "brave-search (inspected latest: 1.0.1)\nsummarize (inspected latest: 1.0.0)\napi-gateway (inspected latest: 1.0.29)\nmarkdown-converter (inspected latest: 1.0.0)\n\nInstall/update:\n\nnpx -y clawhub@latest install brave-search\nnpx -y clawhub@latest install summarize\nnpx -y clawhub@latest install api-gateway\nnpx -y clawhub@latest install markdown-converter\nnpx -y clawhub@latest update --all\n\nVerify:\n\nnpx -y clawhub@latest list" }, { "title": "Required Credentials", "body": "BRAVE_API_KEY (for brave-search)\nMATON_API_KEY (for api-gateway)\nOne summarize model key:\n\nOPENAI_API_KEY, or\nANTHROPIC_API_KEY, or\nXAI_API_KEY, or\nGEMINI_API_KEY\n\nOptional:\n\nFIRECRAWL_API_KEY (for difficult page extraction via summarize)\nAPIFY_API_TOKEN (for YouTube fallback in summarize)\n\nPreflight:\n\necho \"$BRAVE_API_KEY\" | wc -c\necho \"$MATON_API_KEY\" | wc -c\necho \"$OPENAI_API_KEY$ANTHROPIC_API_KEY$XAI_API_KEY$GEMINI_API_KEY\" | wc -c\n\nMandatory behavior:\n\nNever fail silently on missing keys.\nAlways return a MissingAPIKeys section with missing variables and blocked stages.\nContinue with non-blocked stages and clearly mark output as Partial when necessary." }, { "title": "Inputs the LM Must Collect First", "body": "target_url\ntarget_keyword (example: AI tools)\nregion_locale (country/language for SERP interpretation)\ncontent_source (URL fetch, pasted text, or file path)\ncontent_type (blog, category page, product page, landing page)\nbusiness_goal (traffic, leads, sales)\nrewrite_scope (light, moderate, full)\ndata_provider_preference (semrush, ahrefs, gsc-only, none)\n\nDo not run rewrite before keyword intent and content goal are explicit." }, { "title": "brave-search", "body": "Use for live SERP reconnaissance:\n\nfetch top results for the target keyword,\nidentify top competitors and search intent patterns,\ncollect candidate URLs for deeper analysis.\n\nOperational constraints from inspected skill:\n\nrequires BRAVE_API_KEY\nsupports content extraction with --content" }, { "title": "summarize", "body": "Use for structured competitor content analysis:\n\nsummarize each top URL,\nextract heading structure (H1-H4), topic coverage, entity frequency,\nestimate content depth and rhetorical style differences.\n\nOperational constraints from inspected skill:\n\nrequires one supported model API key\ncan use --extract-only, --json, and length controls" }, { "title": "api-gateway", "body": "Use for external SEO data APIs only when active connections exist:\n\nkeyword difficulty,\nbacklink domains,\ncompetitor link intersections,\nsearch performance enrichments.\n\nOperational constraints from inspected skill:\n\nrequires MATON_API_KEY\nalso requires active OAuth/connection per app (ctrl.maton.ai connection lifecycle)\nAPI key alone does not grant third-party data access\n\nImportant capability note:\n\nIn the inspected api-gateway service list, semrush and ahrefs are not listed as native app names.\nUse direct Semrush/Ahrefs integration only if user already has a working gateway connection path for those providers.\nOtherwise fall back to available SEO apps (for example google-search-console) and manual competitor-link extraction." }, { "title": "markdown-converter", "body": "Use to normalize the user's own content into editable Markdown:\n\nconvert input documents/files to Markdown (uvx markitdown ...),\npreserve headings/lists/tables for deterministic rewriting." }, { "title": "Canonical Causal Signal Chain", "body": "Input Stage\n\nuser provides URL + target keyword (+ content source if needed).\n\nSERP Audit Stage (brave-search)\n\npull live SERP and identify top 3 competitors.\ndetect intent class (informational/commercial/transactional).\n\nCompetitor Content Stage (summarize)\n\nanalyze top competitor URLs for:\n\nheading hierarchy,\ntopical breadth and entities,\nuse of statistics/evidence,\nsentence complexity and content length.\n\nData Gate Stage (api-gateway)\n\ncheck whether provider data can be retrieved.\nif keyword difficulty/backlink data is unavailable, ask user for credentials/connection and continue with fallback path.\n\nRequired user-facing gate message format:\n\nDataGateStatus: available / blocked\nReason: missing key, missing connection, or provider unsupported\nAction: exact next step and link(s)\n\nAs of February 14, 2026:\n\nSemrush advertises mainly 7-day toolkit trials on official pages.\nSemrush 14-day trial language is mainly associated with some add-ons or partner offers.\n\nWhen user requests a 14-day Semrush trial:\n\nAsk for their preferred affiliate/referral URL first.\nIf none is provided, share official Semrush trial entry page: https://www.semrush.com/sem/.\nOptionally share Ahrefs free path for verified sites: https://ahrefs.com/webmaster-tools.\n\nOptimization Stage (LLM rewrite)\n\nrewrite user content for intent-match and topical completeness,\nadd natural related terms (LSI-style concept coverage),\nimprove title tag and meta description,\ntighten heading structure and internal linking opportunities.\n\nOutput Stage\n\ndeliver optimized Markdown,\ndeliver prioritized action list,\ndeliver at least 5 backlink source opportunities (with confidence labels)." }, { "title": "Rewrite Policy", "body": "Preserve factual integrity (do not invent statistics or case studies).\nPrefer semantic coverage over keyword stuffing.\nKeep keyword usage natural and intent-aligned.\nAdd scannable structure (clear H2/H3, concise paragraphs, actionable bullets)." }, { "title": "Output Contract", "body": "Always return:\n\nSERPFindings\n\ntop competitors\nobserved intent pattern\nstructural/content gaps versus user page\n\n\n\nDataGateStatus\n\nprovider requested\nkey/connection status\nfallback mode selected\n\n\n\nOptimizedMarkdown\n\nfull rewritten document\nrevised title and meta description\n\n\n\nBacklinkOpportunities\n\n5 sources/domains used by competitors or high-fit alternatives\nrationale per source\nconfidence (high|medium|low)\n\n\n\nNextActions\n\nconcrete implementation checklist (ordered)" }, { "title": "Quality Gates", "body": "Before final output, validate:\n\ntop competitor set is from live SERP, not memory\nrewrite aligns with detected intent\nno fabricated citations or fabricated backlink claims\nkeyword placement is natural (no spam repetition)\nmissing data dependencies are explicitly disclosed\n\nIf any gate fails, return Needs Revision with exact missing evidence." }, { "title": "Failure Handling", "body": "Missing BRAVE_API_KEY: return MissingAPIKeys, skip SERP stage, and request user-provided competitor URLs.\nMissing summarize model key: return MissingAPIKeys, skip summarize stage, and provide structure-only audit from available snippets.\nMissing MATON_API_KEY: return MissingAPIKeys, skip API-gateway enrichment, continue with on-page-only optimization.\nMissing app connection in api-gateway (400): keep pipeline running in fallback mode and return exact connection setup steps.\nUnsupported provider path (for example no Semrush/Ahrefs app connection): disclose limitation and fall back to GSC/manual mode." }, { "title": "Guardrails", "body": "Never claim guaranteed rankings.\nNever represent fallback estimates as provider-verified metrics.\nNever hide dependency failures.\nKeep recommendations specific, measurable, and tied to observed SERP gaps." } ], "body": "Purpose\n\nRun a complete SEO ranking diagnosis and optimization pipeline:\n\ninspect live SERP competition,\ncompare competitor content structure with user content,\nenrich with difficulty/backlink data when API access exists,\nproduce concrete rewrite guidance and an optimized Markdown draft.\n\nThis is an orchestration skill. It does not replace upstream tools.\n\nRequired Installed Skills\nbrave-search (inspected latest: 1.0.1)\nsummarize (inspected latest: 1.0.0)\napi-gateway (inspected latest: 1.0.29)\nmarkdown-converter (inspected latest: 1.0.0)\n\nInstall/update:\n\nnpx -y clawhub@latest install brave-search\nnpx -y clawhub@latest install summarize\nnpx -y clawhub@latest install api-gateway\nnpx -y clawhub@latest install markdown-converter\nnpx -y clawhub@latest update --all\n\n\nVerify:\n\nnpx -y clawhub@latest list\n\nRequired Credentials\nBRAVE_API_KEY (for brave-search)\nMATON_API_KEY (for api-gateway)\nOne summarize model key:\nOPENAI_API_KEY, or\nANTHROPIC_API_KEY, or\nXAI_API_KEY, or\nGEMINI_API_KEY\n\nOptional:\n\nFIRECRAWL_API_KEY (for difficult page extraction via summarize)\nAPIFY_API_TOKEN (for YouTube fallback in summarize)\n\nPreflight:\n\necho \"$BRAVE_API_KEY\" | wc -c\necho \"$MATON_API_KEY\" | wc -c\necho \"$OPENAI_API_KEY$ANTHROPIC_API_KEY$XAI_API_KEY$GEMINI_API_KEY\" | wc -c\n\n\nMandatory behavior:\n\nNever fail silently on missing keys.\nAlways return a MissingAPIKeys section with missing variables and blocked stages.\nContinue with non-blocked stages and clearly mark output as Partial when necessary.\nInputs the LM Must Collect First\ntarget_url\ntarget_keyword (example: AI tools)\nregion_locale (country/language for SERP interpretation)\ncontent_source (URL fetch, pasted text, or file path)\ncontent_type (blog, category page, product page, landing page)\nbusiness_goal (traffic, leads, sales)\nrewrite_scope (light, moderate, full)\ndata_provider_preference (semrush, ahrefs, gsc-only, none)\n\nDo not run rewrite before keyword intent and content goal are explicit.\n\nTool Responsibilities\nbrave-search\n\nUse for live SERP reconnaissance:\n\nfetch top results for the target keyword,\nidentify top competitors and search intent patterns,\ncollect candidate URLs for deeper analysis.\n\nOperational constraints from inspected skill:\n\nrequires BRAVE_API_KEY\nsupports content extraction with --content\nsummarize\n\nUse for structured competitor content analysis:\n\nsummarize each top URL,\nextract heading structure (H1-H4), topic coverage, entity frequency,\nestimate content depth and rhetorical style differences.\n\nOperational constraints from inspected skill:\n\nrequires one supported model API key\ncan use --extract-only, --json, and length controls\napi-gateway\n\nUse for external SEO data APIs only when active connections exist:\n\nkeyword difficulty,\nbacklink domains,\ncompetitor link intersections,\nsearch performance enrichments.\n\nOperational constraints from inspected skill:\n\nrequires MATON_API_KEY\nalso requires active OAuth/connection per app (ctrl.maton.ai connection lifecycle)\nAPI key alone does not grant third-party data access\n\nImportant capability note:\n\nIn the inspected api-gateway service list, semrush and ahrefs are not listed as native app names.\nUse direct Semrush/Ahrefs integration only if user already has a working gateway connection path for those providers.\nOtherwise fall back to available SEO apps (for example google-search-console) and manual competitor-link extraction.\nmarkdown-converter\n\nUse to normalize the user's own content into editable Markdown:\n\nconvert input documents/files to Markdown (uvx markitdown ...),\npreserve headings/lists/tables for deterministic rewriting.\nCanonical Causal Signal Chain\nInput Stage\nuser provides URL + target keyword (+ content source if needed).\nSERP Audit Stage (brave-search)\npull live SERP and identify top 3 competitors.\ndetect intent class (informational/commercial/transactional).\nCompetitor Content Stage (summarize)\nanalyze top competitor URLs for:\nheading hierarchy,\ntopical breadth and entities,\nuse of statistics/evidence,\nsentence complexity and content length.\nData Gate Stage (api-gateway)\ncheck whether provider data can be retrieved.\nif keyword difficulty/backlink data is unavailable, ask user for credentials/connection and continue with fallback path.\n\nRequired user-facing gate message format:\n\nDataGateStatus: available / blocked\nReason: missing key, missing connection, or provider unsupported\nAction: exact next step and link(s)\n\nAs of February 14, 2026:\n\nSemrush advertises mainly 7-day toolkit trials on official pages.\nSemrush 14-day trial language is mainly associated with some add-ons or partner offers.\n\nWhen user requests a 14-day Semrush trial:\n\nAsk for their preferred affiliate/referral URL first.\nIf none is provided, share official Semrush trial entry page: https://www.semrush.com/sem/.\nOptionally share Ahrefs free path for verified sites: https://ahrefs.com/webmaster-tools.\nOptimization Stage (LLM rewrite)\nrewrite user content for intent-match and topical completeness,\nadd natural related terms (LSI-style concept coverage),\nimprove title tag and meta description,\ntighten heading structure and internal linking opportunities.\nOutput Stage\ndeliver optimized Markdown,\ndeliver prioritized action list,\ndeliver at least 5 backlink source opportunities (with confidence labels).\nRewrite Policy\nPreserve factual integrity (do not invent statistics or case studies).\nPrefer semantic coverage over keyword stuffing.\nKeep keyword usage natural and intent-aligned.\nAdd scannable structure (clear H2/H3, concise paragraphs, actionable bullets).\nOutput Contract\n\nAlways return:\n\nSERPFindings\n\ntop competitors\nobserved intent pattern\nstructural/content gaps versus user page\n\nDataGateStatus\n\nprovider requested\nkey/connection status\nfallback mode selected\n\nOptimizedMarkdown\n\nfull rewritten document\nrevised title and meta description\n\nBacklinkOpportunities\n\n5 sources/domains used by competitors or high-fit alternatives\nrationale per source\nconfidence (high|medium|low)\n\nNextActions\n\nconcrete implementation checklist (ordered)\nQuality Gates\n\nBefore final output, validate:\n\ntop competitor set is from live SERP, not memory\nrewrite aligns with detected intent\nno fabricated citations or fabricated backlink claims\nkeyword placement is natural (no spam repetition)\nmissing data dependencies are explicitly disclosed\n\nIf any gate fails, return Needs Revision with exact missing evidence.\n\nFailure Handling\nMissing BRAVE_API_KEY: return MissingAPIKeys, skip SERP stage, and request user-provided competitor URLs.\nMissing summarize model key: return MissingAPIKeys, skip summarize stage, and provide structure-only audit from available snippets.\nMissing MATON_API_KEY: return MissingAPIKeys, skip API-gateway enrichment, continue with on-page-only optimization.\nMissing app connection in api-gateway (400): keep pipeline running in fallback mode and return exact connection setup steps.\nUnsupported provider path (for example no Semrush/Ahrefs app connection): disclose limitation and fall back to GSC/manual mode.\nGuardrails\nNever claim guaranteed rankings.\nNever represent fallback estimates as provider-verified metrics.\nNever hide dependency failures.\nKeep recommendations specific, measurable, and tied to observed SERP gaps." }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/h4gen/seo-ranker", "publisherUrl": "https://clawhub.ai/h4gen/seo-ranker", "owner": "h4gen", "version": "1.0.0", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/seo-ranker", "downloadUrl": "https://openagent3.xyz/downloads/seo-ranker", "agentUrl": "https://openagent3.xyz/skills/seo-ranker/agent", "manifestUrl": "https://openagent3.xyz/skills/seo-ranker/agent.json", "briefUrl": "https://openagent3.xyz/skills/seo-ranker/agent.md" } }