ClawHub Skill Search Rank Checker#

Track the search ranking position of any skill on ClawHub across multiple keywords.

When to Use#

Use this skill when the user wants to:

• Check where their skill ranks for specific search keywords on ClawHub
• Monitor search position changes across multiple keywords
• Compare their skill's ranking against competitors
• Understand which keywords their skill performs best/worst on
• Get keyword ranking data in JSON format for tracking over time

Trigger phrases: "check my skill's ranking", "where does my skill rank", "search position", "keyword ranking", "ClawHub SEO", "排名", "搜索排名", "关键词排名"

How to Use#

1. Single Keyword Rank Check#

To check where a skill ranks for a single keyword:

bash

python3 {{SKILL_DIR}}/scripts/rank_checker.py SKILL_SLUG "keyword"

Replace SKILL_SLUG with the skill's slug (the last part of https://clawhub.ai/owner/SLUG) and "keyword" with the search term.

2. Batch Keyword Rank Check#

To check ranking across multiple keywords at once:

bash

python3 {{SKILL_DIR}}/scripts/rank_checker.py SKILL_SLUG "keyword1" "keyword2" "keyword3"

This will output a summary table showing the rank for each keyword.

3. Show Top Results#

To see the top N results for each keyword (useful for seeing who ranks above you):

bash

python3 {{SKILL_DIR}}/scripts/rank_checker.py SKILL_SLUG "keyword" --top 5

4. Competitor Analysis#

To see skills ranked immediately above and below your skill:

bash

python3 {{SKILL_DIR}}/scripts/rank_checker.py SKILL_SLUG "keyword1" "keyword2" --competitors

5. Verbose Output#

To see full details including scores and descriptions:

bash

python3 {{SKILL_DIR}}/scripts/rank_checker.py SKILL_SLUG "keyword" --verbose --top 10

6. JSON Export#

To get machine-readable output for tracking/scripting:

bash

python3 {{SKILL_DIR}}/scripts/rank_checker.py SKILL_SLUG "keyword1" "keyword2" --json

Output Format#

Text Output (default)#

The text output shows:

• A summary table with keyword → rank mapping
• Emoji medals for top 3 positions (🥇🥈🥉)
• Overall statistics (ranked count, average rank, best rank)

Present the results to the user in a clean markdown table:

KeywordRankNotesstock price🥇 #1/10Best positionstock query🥈 #2/10financeNot in top 10Need optimization

JSON Output#

The JSON output includes:

• skill: the queried slug
• checked_at: timestamp
• results[]: array of per-keyword results, each with keyword, rank, total, rank_display, and optionally top_results[] or competitors[]

Parameters#

ParameterRequiredDescriptionSKILL_SLUGYesThe slug of the skill to check (from ClawHub URL)keywordsYes (1+)One or more search keywords to check ranking for--top NNoShow top N results per keyword--verboseNoShow detailed output with scores and descriptions--competitorsNoShow skills ranked near the target--jsonNoOutput in JSON format

Edge Cases#

• Skill not in results: Reports "Not in top N" — ClawHub search returns up to 10 results per query
• No search results: Some keywords (especially non-English) may return empty results from ClawHub
• Rate limiting: Built-in 0.3s delay between requests; auto-retries on 429 errors
• Network errors: Gracefully reported per-keyword, does not abort the entire batch
• Empty keyword: Rejected with error message

Notes#

• Uses the public ClawHub search API ( GET https://clawhub.ai/api/search?q={keyword}), no authentication needed
• Search results are limited to top 10 by ClawHub's API
• Rankings are real-time snapshots; they may fluctuate based on ClawHub's search algorithm
• For tracking trends over time, use --json output and save/compare results periodically