sm-wordstat: Wordstat stats skill

sm-wordstat

A Python-script skill for Yandex Wordstat statistics: top requests, monthly dynamics and regional distribution

Skill

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
All reasons and checks
Russian stack

bzsega/sm-wordstat

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/sm-wordstat

Detects 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 -y

The 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-wordstat

Commands 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 -y

The 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-wordstat

Commands 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 -y

The 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-wordstat

Commands 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 -y

The 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-wordstat

Commands 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 -y

The 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-wordstat

Commands 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-wordstat

Commands 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 -y

The 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-wordstat

Commands 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 -y

The 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-wordstat

Commands 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 -y

The 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-wordstat

Commands 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-wordstat

Commands 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-wordstat

Commands for macOS and Linux, on Windows run them in Git Bash.

You will need: Node.js

Checked against the repository on Sep 25, 2026, commit d47adb1.

Text for your agent

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 year

Limitations

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.

Official

Official DataLens (Yandex) skills for Claude Code, Codex and OpenCode: SDK, HTML reports and RLS resolution

SkillMedium riskRussian stackNo VPN needed12Repository stars
Editors’ pick

A Yandex Metrika MCP server generated from the API spec: 108 methods, 10 tools declared by default, transparent filters and response metadata

MCP serverMedium riskRussian stackNo VPN needed2Repository stars
Official

An open MCP server and agent skill set for SEO: keyword research, competitors, backlinks and site audits powered by DataForSEO

MCP serverMedium risk21.5KRepository stars

A Claude Code plugin for SEO audits: technical SEO, E-E-A-T, schema, local and AI search via parallel subagents

PluginHigh risk17.9KRepository stars
Foxx AIsm-wordstat: Wordstat stats skill

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.