Clawhub Skills Rank

Track and monitor the search ranking position of any ClawHub skill across multiple keywords. Check where your skill ranks for 'stock price', 'todo app', etc....

Security Scan

The skill's files, instructions, and requirements are consistent with its stated purpose (checking ClawHub skill search rankings); it only needs Python and calls the public ClawHub search API, with no unexplained credential or install requirements.

Purpose & Capability

Name/description match the actual behavior: the package contains a Python script that queries https://clawhub.ai/api/search and computes ranks. Required binary is python3, which is appropriate for a Python script. No credentials, unrelated binaries, or config paths are requested.

Instruction Scope

SKILL.md instructs the agent (or user) to run the bundled Python script with a skill slug and keywords. The instructions and script only reference the ClawHub search API and local output (text/JSON). They do not request reading arbitrary files, environment secrets, or sending data to third-party endpoints other than clawhub.ai.

Install Mechanism

There is no install spec (instruction-only) but the bundle includes a runnable Python script. No external downloads or package installs are performed. This is low risk but note that the code will be executed locally when invoked.

Credentials

No environment variables, credentials, or config paths are required. The script performs only outbound HTTPS requests to the documented public API and performs local formatting—no access to unrelated secrets is requested.

Persistence & Privilege

Skill does not request always:true, does not modify other skills or system configuration, and has no persistence/install steps. It runs on demand and has normal, limited privileges.

Assessment

This skill appears coherent and limited to querying ClawHub's public search API. If you plan to install or run it, verify you trust the source (the package has no homepage and an unknown owner ID), run it in a controlled environment if you are cautious, and inspect or run the included scripts locally (they only use Python standard library and call the documented API). If you need stricter guarantees, ask the maintainer for a provenance/source URL or prefer packages hosted on a known repository.

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:

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:

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):

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:

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

5. Verbose Output

To see full details including scores and descriptions:

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

6. JSON Export

To get machine-readable output for tracking/scripting:

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:

Keyword	Rank	Notes
stock price	🥇 #1/10	Best position
stock query	🥈 #2/10
finance	Not in top 10	Need 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

Parameter	Required	Description
SKILL_SLUG	Yes	The slug of the skill to check (from ClawHub URL)
keywords	Yes (1+)	One or more search keywords to check ranking for
--top N	No	Show top N results per keyword
--verbose	No	Show detailed output with scores and descriptions
--competitors	No	Show skills ranked near the target
--json	No	Output 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