Yandex search API skill via Apify
claude-skill-yandex-search-api
An agent skill: the full Yandex SERP as JSON with no official API key, via the Apify Yandex Search Scraper actor
Medium risk
We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.
Why this level
- Usage is billed through a third-party Apify account and grows with the number of queries with no built-in limit
- Data comes from scraping the results page, not from Yandex's official API
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/claude-skill-yandex-search-apiDetects the agents on your machine, checks the risk and pins the version.
Other ways to install
Run one by one in the Claude Code chat
/plugin marketplace add johnisanerd/claude-skill-yandex-search-api
/plugin install apify-yandex-search-api@claude-skill-yandex-search-apiInstall the skill with npx skills add johnisanerd/claude-skill-yandex-search-api, log in with apify login or set APIFY_TOKEN, then ask the agent for the SERP for your query.
Other ways from the author
npx skills add johnisanerd/claude-skill-yandex-search-apiInstall command from the README; requires an Apify account and APIFY_TOKEN.
This is third-party code. Review the repository files before installing.
What it does
The skill wraps a third-party Apify actor, johnvc/Scrape-Yandex: one query returns the full Yandex SERP as structured JSON, organic results with position, title, link, displayed link and snippet, plus optional ads, a knowledge graph and inline images and videos. You can target a Yandex domain, language and any of over 123,000 lr region IDs. Billing runs through an Apify account, per page per run. A companion skill for image search installs separately.
Who it is for. For SEO specialists and market researchers who need the Yandex SERP as data without going through official Search API access.
Good fit when
- You need a one-off ranking check without setting up a Yandex Cloud key
- You want ads, a knowledge graph or inline media alongside organic results
- Paying through Apify is fine, without a separate arrangement with Yandex
Not a fit when
- You need the official Yandex Search API v2 with an SLA guarantee: this uses a third-party scraper
- You need bulk collection across many keywords: the author has a separate per-result skill for that
Example request
Show what currently ranks in Yandex's top 10 for apartment rental in MoscowLimitations
The skill depends on a third-party paid Apify actor rather than Yandex's official API; changes to the results page markup or blocks can affect the actor without notice. An Apify account and an APIFY_TOKEN are required. Billing is a small per-run fee plus a per-page fee, so cost grows with the number of queries.
How to disable. Delete the apify-yandex-search-api folder from your agent's skills directory.
Security check
- Usage is billed through a third-party Apify account and grows with the number of queries with no built-in limit
- Data comes from scraping the results page, not from Yandex's official API
README in short
The README describes the skill as a wrapper around the Apify Yandex Search Scraper actor, shows install via npx skills add or copying the folder, mentions per-page billing, and links to the companion image-search skill.
SKILL.md
--- name: apify-yandex-search-api description: Get structured Yandex search results without an official API key using the Apify Yandex Search Scraper Actor (johnvc/Scrape-Yandex). One query returns the full SERP as JSON, with organic results (position, title, link, displayed_link, snippet), and optional ads, knowledge graph, inline images, and inline videos, targeted by Yandex domain, language, and any of 123,000 plus lr region IDs. author: John Cole author_url: https://github.com/johnisanerd license: MIT --- # Yandex Search API: Full SERP Results as JSON A Yandex search API without an official API key. One query returns the full Yandex SERP as structured JSON: organic results with positions and sitelinks, plus ads, knowledge graph, and inline media when you ask for them, targeted to any Yandex domain, language, and region. ## When to use this skill - The user wants a Yandex search API or Yandex SERP API without registering for an official key. - They want Yandex search results as JSON or CSV for a query, market, or region. - They want to see what ranks on yandex.ru for a query, by city or region. - They are doing SEO or competitor research for Russian-speaking markets. ## Prerequisites - Apify account. - Authentication via apify login, or an APIFY_TOKEN environment variable.
FAQ
Do I need an official Yandex key?
No, the skill uses a third-party Apify actor instead of the official Search API; no Yandex key is needed, but an Apify token is.
What does it cost?
A small per-run fee plus a per-page fee; exact numbers are in references/gotchas.md inside the skill.
Related
CLI, skill and Python library for browser control: the agent clicks, fills forms and reads pages over CDP
A skill that gathers the last 30 days of discussion on a topic from Reddit, X, YouTube, HN, Polymarket and GitHub into one brief
The Chrome DevTools team's official MCP server: the agent drives a live Chrome, reads network and console, and records performance traces
A fast Rust CLI for agent browser automation: accessibility snapshots with element refs, an MCP server and skills