Official agent skill

Apify Yandex Search API

by apify in apify/awesome-skills

Get structured Yandex search results without an official API key using the Apify Yandex Search Scraper Actor (johnvc/Scrape-Yandex).

OfficialMITAuto-check passedData & Analytics

Install Apify Yandex Search API

skills CLI
$ npx skills add apify/awesome-skills --skill apify-yandex-search-api -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install apify/awesome-skills apify-yandex-search-api --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/apify/awesome-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/apify-yandex-search-api .claude/skills/apify-yandex-search-api && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
apify-yandex-search-api
GitHub stars
264
Token cost
~2.1k tokens
SKILL.md length
840 words
Files
3 (incl. references)
Skills in repo
25
Repo updated
First seen
Licence
MIT

At a glance

Get structured Yandex search results without an official API key using the Apify Yandex Search Scraper Actor (johnvc/Scrape-Yandex).

  • Works in 5 steps: Fetch the current input schema with… → Choose result types. Organic is on by… → Bound the volume. max_pages (default 2)… → …
  • The user wants a yandex search api
  • SKILL.md covers When to use this skill, What you get (one dataset item…, Prerequisites and The Actor, plus 8 more sections
  • Reaches mcp.apify.com; needs APIFY_TOKEN

What it does

Apify Yandex Search API is an agent skill from apify/awesome-skills, published by the product's own GitHub organization. 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, displayedlink, 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. Use when the user wants a yandex search api, a yandex serp api, Yandex search results as JSON or CSV, to scrape Yandex search, to…

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/actor-index.md` and `references/gotchas.md`).

It sits in Data & Analytics, covering Web scraping. It works with Apify, Model Context Protocol and SerpApi. The repository describes itself as: Community collection of Apify agent skills for AI coding assistants. The licence is MIT.

When your agent uses it

  • The user wants a yandex search api
  • A yandex serp api
  • Yandex search results as JSON
  • Scrape Yandex search

Example prompts

  • “/apify-yandex-search-api”

Requirements

  • A credential in APIFY_TOKEN

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Fetch the current input schema with apify actors info "johnvc/Scrape-Yandex" --input --json --user-agent…
  2. Choose result types. Organic is on by default; flip include_ads, include_knowledge_graph, include_inline_images, or include_inline_videos…
  3. Bound the volume. max_pages (default 2) is the cost driver; sort_mode "date" and period narrow to recent results.
  4. Estimate cost, then confirm with the user if the run is large. See references/gotchas.md.
  5. Run the Actor, then read the completed run’s defaultDatasetId into DATASET_ID and fetch its rows with apify datasets get-items…

What it can do on your machine

Read from SKILL.md and the folder at commit 1eb0cd0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • mcp.apify.com

    Also links to:

    • apify.com
    • docs.apify.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • APIFY_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Apify Yandex Search API loads about 2.1k tokens when it runs, and up to ~3.2k if it reads all its reference files. Until then it costs about 177 tokens; SKILL.md has 840 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~177
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from apify/awesome-skills at commit 1eb0cd0, republished under its MIT licence (© apify). 840 words, ~2,055 tokens.

Download SKILL.mdSave it as .claude/skills/apify-yandex-search-api/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
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. Use when the user wants a yandex search api, a yandex serp api, Yandex search results as JSON or CSV, to scrape Yandex search, to check what ranks on yandex.ru for a query or region, or SEO research for Russian-speaking markets. Pay-per-page billing, MCP-ready for Claude and other AI agents.
author
John Cole (links use the author’s Apify affiliate code; routed Actors are built by the author)
author_url
https://github.com/johnisanerd
license
MIT
metadata.version
1.0
metadata.keywords
apify, yandex, yandex-search, serp, search-api, seo, json, mcp, claude
metadata.category
data-extraction

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.

Not for: keyword rank tracking over time (use the pay-per-result Yandex edition), reverse image lookups (use the Yandex Reverse Image Search Actor), or Google SERPs.

What you get (one dataset item per page, tagged by item_type)

Each dataset item is one page of one result type, tagged with item_type (organic, ads, knowledge_graph, inline_images, inline_videos). The results sit in a nested array on that item: organic_results holds rows with position, title, link, displayed_link, snippet (plus date, rich_snippet, and sitelinks when Yandex shows them); the optional types use ads_results, knowledge_graph, inline_images, and inline_videos arrays. Every item also carries page metadata: total_results_found, page_number, pages_processed, pagination_limit_reached.

Prerequisites

The Actor

Run it with the Apify CLI

Organic results for a query on yandex.com:

bash
apify actors call "johnvc/Scrape-Yandex" -i '{"text":"crm software","max_pages":2}' \
  --json \
  --user-agent apify-awesome-skills/apify-yandex-search-api \
  2>/dev/null

Full Russian SERP for Moscow (lr 213), organic plus ads plus knowledge graph:

bash
apify actors call "johnvc/Scrape-Yandex" -i '{"text":"купить ноутбук","yandex_domain":"yandex.ru","lang":"ru","lr":213,"include_ads":true,"include_knowledge_graph":true,"max_pages":2}' \
  --json \
  --user-agent apify-awesome-skills/apify-yandex-search-api \
  2>/dev/null

Every call carries the three flags this repo expects: --json, --user-agent apify-awesome-skills/apify-yandex-search-api, and 2>/dev/null.

Run it from Claude or another AI agent (MCP)

The Actor is MCP-ready. Add the hosted server URL:

https://mcp.apify.com/?tools=actors,docs,johnvc/Scrape-Yandex

Then ask, for example: "Get the first two pages of Yandex results for 'hotel booking' on yandex.ru and list the organic links with positions." MCP setup docs: https://docs.apify.com/platform/integrations/mcp

Workflow

  1. Fetch the current input schema with apify actors info "johnvc/Scrape-Yandex" --input --json --user-agent apify-awesome-skills/apify-yandex-search-api 2>/dev/null (read taggedBuilds.latest.build.inputSchema), then build the query. text is the only required field. Pick yandex_domain (six domains), lang (19 languages), and lr (region ID, for example 213 for Moscow, 2 for Saint Petersburg) for the market you care about.
  2. Choose result types. Organic is on by default; flip include_ads, include_knowledge_graph, include_inline_images, or include_inline_videos as needed. Each page of each type comes back as its own dataset item tagged with item_type.
  3. Bound the volume. max_pages (default 2) is the cost driver; sort_mode "date" and period narrow to recent results.
  4. Estimate cost, then confirm with the user if the run is large. See references/gotchas.md.
  5. Run the Actor, then read the completed run’s defaultDatasetId into DATASET_ID and fetch its rows with apify datasets get-items "$DATASET_ID" --format json --user-agent apify-awesome-skills/apify-yandex-search-api 2>/dev/null. Check all items for error and error_message before filtering by item_type, then read the nested array on each item (organic_results for the web SERP). Flatten the arrays client-side if the user wants CSV.
Show full SKILL.md (316 more words)Show less

Inputs

  • text (string, required): the search query
  • yandex_domain (enum, 6 domains, default yandex.com)
  • lang (enum, 19) and lr (integer region ID, 123,000 plus locations)
  • include_organic_results (default true), include_ads, include_knowledge_graph, include_inline_images, include_inline_videos (booleans)
  • max_pages (integer, default 2) and groups_on_page (default 10)
  • sort_mode (relevance or date), period, family_mode, fix_typo

For video results in the web SERP, set include_inline_videos: true and keep include_organic_results: true. Read inline_videos on items with item_type: "inline_videos"; return title, duration, and source_link when present (link opens the Yandex preview). For the dedicated Images vertical (include_image_search), see the Yandex image search API skill. Dedicated video search (include_video_search) is a separate Actor mode; see references/gotchas.md before using it.

Cost

Billing is a small one-time start fee per run plus a per-page fee, so cost is roughly proportional to max_pages. A default two-page run costs well under a dollar; live prices and thresholds are in references/gotchas.md.

Honest limits

  • Keep page_number with position: positions restart on each page. Positions reflect the SERP at crawl time for the chosen lr region; they vary by region and personalization-free crawling can still fluctuate run to run.
  • This skill reads the SERP; it does not track ranks over time (that is the pay-per-result edition's job).
  • Knowledge graph, ads, and inline media appear only when Yandex shows them for that query.

Troubleshooting

  • Empty organic results: check the query on the chosen domain manually; try fix_typo true and a broader query.
  • Wrong-market results: set yandex_domain, lang, and lr together; lr alone does not switch language.
  • pagination_limit_reached true means the configured page limit was reached. For fewer pages, inspect returned items and run errors before assuming Yandex ran out of results.

See references/gotchas.md for cost guardrails and error recovery, and references/actor-index.md for the Actor routing table.

© apify, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in skills/apify-yandex-search-api of apify/awesome-skills.

  • SKILL.md
  • references/actor-index.md
  • references/gotchas.md

Open the folder on GitHubat commit 1eb0cd0

Compare with similar skills

Apify Yandex Search API next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Apify Yandex Search API compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Apify Yandex Search API this skillapify/awesome-skills264—~2.1kAutomated safety check: PassMIT
Etsy Search Listingssickn33/agentic-awesome-skills47k1 repos~1.2kAutomated safety check: PassMIT
Apify Product Lookupdavepoon/buildwithclaude3.6k—~1.4kAutomated safety check: PassMIT
Fallback And Resilienceborski/travel-hacking-toolkit688—~1.6kAutomated safety check: PassMIT
Youtube Apify Transcriptmajiayu000/claude-skill-registry6662 repos~1kAutomated safety check: NotesMIT
Ketch1broseidon/ketch6971 repos~3.9kAutomated safety check: PassMIT

Similar skills

  • Etsy Search Listings

    sickn33/agentic-awesome-skills

    Fetch live Etsy search listing rows for a keyword, market phrase, or category via Apify Actor publicrecords/etsy-search-scraper (MCP).

    47k GitHub starsUsed in 1 repo~1.2k tokens
    Data & AnalyticsAuto-check passed
  • Apify Product Lookup

    davepoon/buildwithclaude

    Fetch a real product's current price, stock, rating, or images from retailer pages over the Apify MCP server, and return them as typed fields rather than prose.

    3.6k GitHub stars~1.4k tokensUpdated 2 days ago
    Data & AnalyticsAuto-check passed
  • Fallback And Resilience

    borski/travel-hacking-toolkit

    What to do when a tool fails, an API hits a rate limit, or a site blocks scraping.

    688 GitHub stars~1.6k tokensUpdated 3 days ago
    Backend & APIsAuto-check passed
  • Youtube Apify Transcript

    majiayu000/claude-skill-registry

    Fetch YouTube transcripts via APIFY API. An agent skill from majiayu000/claude-skill-registry.

    666 GitHub starsUsed in 2 repos~1k tokens
    Data & AnalyticsAuto-check: notes
  • Ketch

    1broseidon/ketch

    Research skill for ketch — a fast stateless CLI for web search, OSS code search, curated library docs, page scraping, and site crawling; an optional MCP server exists for operators who want it, but…

    697 GitHub starsUsed in 1 repo~3.9k tokens
    Data & AnalyticsAuto-check passed
  • Querying Indonesian Gov Data

    suryast/indonesia-gov-apis

    Query 57 Indonesian government APIs and data sources — BPJPH halal certification, BPOM food safety, OJK financial legality, BPS statistics, BMKG weather/earthquakes, Bank Indonesia exchange rates…

    172 GitHub stars~997 tokensUpdated yesterday
    Data & AnalyticsAuto-check passed

More from apify/awesome-skills

All 25 skills in this repo
  • Apify Buying Signal Detection

    apify/awesome-skills

    Official

    Set up a recurring buying-signal detection pipeline that finds companies showing buying intent across three signal types — job postings (hiring for the persona), fundraising events (recent raises)…

    264 GitHub stars~5.1k tokensUpdated 16 days ago
    Auto-check: notes
  • Apify Lead Scoring Enrichment

    apify/awesome-skills

    Official

    Score and enrich a CSV of B2B leads using Apify Actors. An agent skill from apify/awesome-skills.

    264 GitHub stars~4.4k tokensUpdated 16 days ago
    Auto-check: notes
  • Apify Product Data Setup

    apify/awesome-skills

    Official

    Wire an AI agent to live e-commerce product data using Apify's E-commerce Scraping Tool over MCP, either as runtime tool calls or as a scheduled refresh into a vector store.

    264 GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Official

    Build TypeScript Apify orchestrator Actors — coordinate a sequence of sub-Actors (optionally with an LLM step) using the apify-orchestrator library.

    264 GitHub starsUsed in 1 repo~3k tokens
    Auto-check: warnings
  • Apify App Store Intelligence

    apify/awesome-skills

    Official

    Pull structured Apple App Store and Google Play data — app metadata, price, rating, the 1–5★ ratings histogram, version, developer, and reviews — and watch it for changes over time.

    264 GitHub stars~3.5k tokensUpdated 16 days ago
    Auto-check passed
  • Apify Ashby Jobs Scraper

    apify/awesome-skills

    Official

    Scrape Ashby jobs or discover companies using Ashby with the Apify Ashby Job Board API Actor (johnvc/ashby-job-board-scraper).

    264 GitHub stars~3.7k tokensUpdated 16 days ago
    Auto-check passed

Questions about Apify Yandex Search API

What does Apify Yandex Search API do?

Get structured Yandex search results without an official API key using the Apify Yandex Search Scraper Actor (johnvc/Scrape-Yandex). Apify Yandex Search API is an agent skill from apify/awesome-skills, published by the product's own GitHub organization. Get structured Yandex search results without an official API key using the Apify Yandex Search Scraper Actor (johnvc/Scrape-Yandex).

When should I use Apify Yandex Search API?

Apify Yandex Search API fits situations like: the user wants a yandex search api; A yandex serp api; yandex search results as JSON; scrape Yandex search.

How do I install Apify Yandex Search API in Claude Code?

Run `npx skills add apify/awesome-skills --skill apify-yandex-search-api -a claude-code`. Or copy the skill folder (skills/apify-yandex-search-api in apify/awesome-skills) into .claude/skills/apify-yandex-search-api in your project. Claude Code loads it when a task matches its description.

How do I install Apify Yandex Search API in Codex?

Run `npx skills add apify/awesome-skills --skill apify-yandex-search-api -a codex`. Or copy the skill folder (skills/apify-yandex-search-api in apify/awesome-skills) into .agents/skills/apify-yandex-search-api in your project. Codex loads it when a task matches its description.

Can I use Apify Yandex Search API in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add apify/awesome-skills --skill apify-yandex-search-api -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/apify-yandex-search-api, .gemini/skills/apify-yandex-search-api, .github/skills/apify-yandex-search-api and .opencode/skills/apify-yandex-search-api in your project.

What does Apify Yandex Search API need to run?

Going by SKILL.md and its folder, Apify Yandex Search API needs credentials named APIFY_TOKEN. Our summary lists: A credential in APIFY_TOKEN.

Does Apify Yandex Search API access the network?

SKILL.md names 3 domains. In commands or code: mcp.apify.com; the agent is likely to contact it when it follows the instructions. As links in the text: apify.com and docs.apify.com. This is read from the text; nothing was executed.

Is Apify Yandex Search API safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Apify Yandex Search API use?

Apify Yandex Search API is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Apify Yandex Search API use?

About 2.1k tokens (SKILL.md is roughly 8.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.2k tokens, read only when the agent opens those files.

What are the alternatives to Apify Yandex Search API?

Skills that share tags, products or a category with Apify Yandex Search API: Etsy Search Listings (sickn33/agentic-awesome-skills, 47k stars), Apify Product Lookup (davepoon/buildwithclaude, 3.6k stars), Fallback And Resilience (borski/travel-hacking-toolkit, 688 stars) and Youtube Apify Transcript (majiayu000/claude-skill-registry, 666 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Apify Yandex Search API?

apify (a GitHub organization, an official publisher) maintains it in apify/awesome-skills, which has 264 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on September 22, 2026.

Source: apify/awesome-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.