sm-wordstat: Wordstat stats skill
sm-wordstat
A Python-script skill for Yandex Wordstat statistics: top requests, monthly dynamics and regional distribution
Low risk
We rate an entry low when it mostly gives the agent instructions and reference material.
Why this level
- Only reads search query statistics through the official API
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/sm-wordstatDetects the agents on your machine, checks the risk and pins the version.
Other ways to install
Run in a terminal in the project folder
npx skills add bzsega/sm-wordstat --skill sm-wordstat -a claude-code -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit d47adb1
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bzsega/sm-wordstat.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/sm-wordstat/
git -C "$tmp" checkout d47adb10e58ed6c1e53fd89a698b19c6da0b5ae8
mkdir -p .claude/skills
cp -R "$tmp/skills/sm-wordstat" .claude/skills/sm-wordstatCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add bzsega/sm-wordstat --skill sm-wordstat -a cursor -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit d47adb1
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bzsega/sm-wordstat.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/sm-wordstat/
git -C "$tmp" checkout d47adb10e58ed6c1e53fd89a698b19c6da0b5ae8
mkdir -p .agents/skills
cp -R "$tmp/skills/sm-wordstat" .agents/skills/sm-wordstatCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add bzsega/sm-wordstat --skill sm-wordstat -a github-copilot -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit d47adb1
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bzsega/sm-wordstat.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/sm-wordstat/
git -C "$tmp" checkout d47adb10e58ed6c1e53fd89a698b19c6da0b5ae8
mkdir -p .github/skills
cp -R "$tmp/skills/sm-wordstat" .github/skills/sm-wordstatCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add bzsega/sm-wordstat --skill sm-wordstat -a codex -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit d47adb1
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bzsega/sm-wordstat.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/sm-wordstat/
git -C "$tmp" checkout d47adb10e58ed6c1e53fd89a698b19c6da0b5ae8
mkdir -p .agents/skills
cp -R "$tmp/skills/sm-wordstat" .agents/skills/sm-wordstatCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add bzsega/sm-wordstat --skill sm-wordstat -a gemini-cli -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit d47adb1
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bzsega/sm-wordstat.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/sm-wordstat/
git -C "$tmp" checkout d47adb10e58ed6c1e53fd89a698b19c6da0b5ae8
mkdir -p .agents/skills
cp -R "$tmp/skills/sm-wordstat" .agents/skills/sm-wordstatCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bzsega/sm-wordstat.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/sm-wordstat/
git -C "$tmp" checkout d47adb10e58ed6c1e53fd89a698b19c6da0b5ae8
mkdir -p .devin/skills
cp -R "$tmp/skills/sm-wordstat" .devin/skills/sm-wordstatCommands for macOS and Linux, on Windows run them in Git Bash.
Formerly Windsurf.
Run in a terminal in the project folder
npx skills add bzsega/sm-wordstat --skill sm-wordstat -a cline -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit d47adb1
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bzsega/sm-wordstat.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/sm-wordstat/
git -C "$tmp" checkout d47adb10e58ed6c1e53fd89a698b19c6da0b5ae8
mkdir -p .cline/skills
cp -R "$tmp/skills/sm-wordstat" .cline/skills/sm-wordstatCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add bzsega/sm-wordstat --skill sm-wordstat -a roo -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit d47adb1
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bzsega/sm-wordstat.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/sm-wordstat/
git -C "$tmp" checkout d47adb10e58ed6c1e53fd89a698b19c6da0b5ae8
mkdir -p .roo/skills
cp -R "$tmp/skills/sm-wordstat" .roo/skills/sm-wordstatCommands for macOS and Linux, on Windows run them in Git Bash.
A fork of Roo Code, same .roo folders.
Run in a terminal in the project folder
npx skills add bzsega/sm-wordstat --skill sm-wordstat -a opencode -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit d47adb1
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bzsega/sm-wordstat.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/sm-wordstat/
git -C "$tmp" checkout d47adb10e58ed6c1e53fd89a698b19c6da0b5ae8
mkdir -p .agents/skills
cp -R "$tmp/skills/sm-wordstat" .agents/skills/sm-wordstatCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bzsega/sm-wordstat.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/sm-wordstat/
git -C "$tmp" checkout d47adb10e58ed6c1e53fd89a698b19c6da0b5ae8
mkdir -p .agents/skills
cp -R "$tmp/skills/sm-wordstat" .agents/skills/sm-wordstatCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bzsega/sm-wordstat.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/sm-wordstat/
git -C "$tmp" checkout d47adb10e58ed6c1e53fd89a698b19c6da0b5ae8
mkdir -p .agents/skills
cp -R "$tmp/skills/sm-wordstat" .agents/skills/sm-wordstatCommands for macOS and Linux, on Windows run them in Git Bash.
Clone bzSega/sm-wordstat, copy the skills/sm-wordstat folder into your skills installation, set WORDSTAT_API_KEY and WORDSTAT_FOLDER_ID, then call python skills/sm-wordstat/scripts/wordstat.py top "phrase".
This is third-party code. Review the repository files before installing.
What it does
The skill gives an agent access to Yandex Wordstat data through a separate standalone Python script, with no browser and no captcha workaround. It supports three commands: top for a list of queries with volumes, dynamics for monthly frequency changes, and regions for the distribution of impressions across Russian regions. It runs directly as python wordstat.py with a command and a quoted phrase, reading the key and folder id from the WORDSTAT_API_KEY and WORDSTAT_FOLDER_ID environment variables.
Who it is for. For people who want a lightweight Wordstat stats skill without setting up an MCP server
Good fit when
- You want to quickly check a phrase's volume and dynamics right from a chat with an agent
- You need the regional distribution of impressions for a specific query
- You do not want to run an MCP server and a script is enough
Not a fit when
- You need full Wordstat API coverage with a region tree and cost tracking
- You need agents that do not work with SKILL.md-style skills
Example request
Get the monthly dynamics for the query "english courses" for this yearLimitations
The repository is small: a README, SKILL.md and one Python script, with no stars. The README lists Jeeves and OpenClaw as target platforms alongside Claude Code, without platform-specific notes. You need your own Yandex Cloud Search API key.
How to disable. Remove the skills/sm-wordstat folder from your skills installation.
Security check
- Only reads search query statistics through the official API
README in short
The README describes three capabilities: top requests with volumes, monthly dynamics, and a distribution across Russian regions, stressing that it works without a browser or captcha via the official API. It lists the requirements: Python 3.10 and a Yandex Cloud key, plus the script run command with an example phrase.
FAQ
Does it need a browser or a captcha workaround?
No, the script calls the Yandex Cloud Search API directly with a key, no browser or captcha involved.
Which commands are available?
top, dynamics and regions, each taking a quoted phrase as the first argument.
Related
Official DataLens (Yandex) skills for Claude Code, Codex and OpenCode: SDK, HTML reports and RLS resolution
A Yandex Metrika MCP server generated from the API spec: 108 methods, 10 tools declared by default, transparent filters and response metadata
An open MCP server and agent skill set for SEO: keyword research, competitors, backlinks and site audits powered by DataForSEO
A Claude Code plugin for SEO audits: technical SEO, E-E-A-T, schema, local and AI search via parallel subagents