/xmlstock

name: xmlstock
description: "[RU: интеграция xmlstock.com — Яндекс Search API, Яндекс Live, Google XML Search, парсинг SERP/картинок/видео/новостей] xmlstock.com REST API — RU reseller дешёвых XML-лимитов для Яндекс Search API (~18 руб/1000 vs официальные 480), Яндекс Live (живая выдача с ads/scroller/related), Google XML Search. Async/hybrid режимы с req_id и кодом 210/202, params query/lr/page/domain/device/tbm/groupby/sortby/filter/maxpassages/related/ads, parsing картинок (tbm=images), видео (tbm=video), новостей (tbm=news, только Google), мобильная выдача (device=mobile), POST-режим с XML-body. Use when: xmlstock, xmlstock.com, яндекс xml, yandex search api, yandex.xml, яндекс лимиты, парсинг выдачи яндекса, парсинг google, google xml search, проверка позиций, проверка индексации, SERP parsing, парсинг сниппетов, req_id, delayed=1, tbm=images, scroller, related searches, парсинг рекламной карусели, key collector xml, topsite xml, проверка позиций сайта, ошибка 210, ошибка 202, ошибка 32, hybrid режим. SKIP: Mutagen (→mutagen, frequency/Wordstat, not SERP scraping); proxy для собственного скрапинга SERP (→proxy6, dramatically more expensive at scale); Bing/DuckDuckGo (different provider, xmlstock не поддерживает); официальное Yandex Search API напрямую (~100x дороже); Google Custom Search JSON API (different surface, limit 100/day free)."
stacks:
  - xmlstock
  - ru-seo
  - python
  - nodejs
tags:
  - seo
  - ru
  - serp
  - yandex
  - google
  - parsing
  - xml
  - positions
source: vechkasov-global-skills
risk: high-stakes

<!-- versions:start -->

🎯 Version Requirements (August 2026)

**Primary pins:**

• xmlstock API: `docs-only (stable JSON/XML REST, no version path; https://xmlstock.com/{yandex|yandexlive|google}/{xml|json|html}/)`
• Python: `3.14.x`
• Node.js: `24.x (Active LTS)`

> Source of truth: [STACK_VERSIONS.md](../../STACK_VERSIONS.md) — verified 2026-08-24

<!-- versions:end -->

Usage

Loaded automatically when its description matches the active task. Read only the section you need, then follow the link to the relevant reference file for full detail.

Use this skill when

• Парсинг позиций сайта в Яндексе или Google по списку ключей с региональностью (`lr=`, `domain=`, `device=`)
• Проверка индексации страниц / количества проиндексированных страниц через `query=site:domain.com`
• Сбор SERP-снапшотов (ТОП-10/50/100) для аналитики, мониторинга конкурентов, кластеризации
• Парсинг живой выдачи Яндекса с дополнительными блоками: реклама Яндекс.Директ (`ads=1`), товарная карусель (`scroller=1`), Related Searches (`related=1`)
• Парсинг Яндекс/Google картинок (`tbm=images`), Google новостей (`tbm=news`), видео (`tbm=video`)
• Обратный поиск по картинкам в Яндексе через `query=image:URL` + `tbm=images`
• Замена прямого скрапинга через прокси/решение капч на стабильный API за ~18 руб/1000 запросов (≈100× дешевле официального Yandex Search API)
• Интеграция Key Collector / Topvisor / Site-Control / Topsite через готовый URL `https://xmlstock.com/{engine}/xml/?user=...&key=...`
• Building a Python / Node.js client с async-polling req_id, dedup, balance pre-check, retry на 210/202 с exponential backoff
• Asynchronous (`delayed=1`) batch SERP parsing для больших объёмов с гибким контролем (нет квот, только пропускная способность их сервера)

Do not use this skill when

• Сбор частотностей / уровня конкуренции / Wordstat — это **не** делает xmlstock. Использовать `mutagen` (cascade marker) для wordstat_qso и `strong`
• Собственный скрапер SERP через прокси / разгадывание капч — на масштабах >5к запросов это дороже и менее стабильно. Если запросов очень мало (<100/мес) — пользователь не обязан подключать сторонний сервис; для прокси — `proxy6` (cascade marker)
• Других поисковиков: Bing, DuckDuckGo, Baidu — xmlstock поддерживает только Яндекс и Google
• Прямой Yandex Search API (api.search.yandex.ru) — другой endpoint, другие цены, другая аутентификация. Этот скилл — про reseller xmlstock, а не про официальный API
• Google Custom Search JSON API (CSE) — другой surface, JSON-only, 100 бесплатных/день; разные параметры
• Использование собранных данных downstream (HTTP-плeerинг, БД, аналитика) — это работа runtime-скиллов (`httpx`, `nodejs`, `postgresql`)
• Парсинг SERP-фич сложнее базовых блоков (People Also Ask с раскрытием, Knowledge Graph, Featured Snippets с разметкой) — xmlstock возвращает только то, что описано; для подобного — SerpApi/DataForSEO (другие сервисы, дороже)

Purpose

xmlstock.com — крупнейший российский reseller XML-лимитов для Яндекс Search API (платный новый API, заменивший бесплатный Яндекс.XML с 1 ноября 2023) и аналогичный сервис для Google. Цены: ~18 руб/1000 запросов к Яндекс XML (vs 480 руб официальные днём и 360 ночью — ≈100× дешевле благодаря договорённости с командой Яндекса), сопоставимые на Google. Поддерживает все официальные параметры выдачи плюс Live-парсинг с экстра-блоками (Яндекс.Директ ads, товарная карусель, related searches), мобильную выдачу, картинки/видео/новости, async-режим с req_id.

This skill is **high-stakes** because:

1. **Платно за каждый ответ**. За ошибки 1, 15, 18, 19, 37, 210, 10001, 10002 деньги списываются (запрос обработан, формально корректен). За остальные ошибки — нет. 2. **Async double-spend trap**: повторная отправка `delayed=1` для того же запроса создаёт **новую** задачу с новым req_id и списанием. Нужно persist req_id и поллить только по нему. 3. **Hybrid режим (по умолчанию для Яндекс XML)** возвращает либо результат, либо `error code=210` (запрос поставлен в очередь). Повторный запрос за 210-результатом **не** тарифицируется, но требует терпения 20-30 секунд между retry, иначе ловишь 201 (повторный запрос из кеша не чаще раза в 30 с — для async). 4. **Region (`lr=`) драматически меняет SERP**. Промах с регионом = собранные позиции бесполезны = деньги выброшены. Перед батчем — проверить настройки по умолчанию в ЛК и явно передавать `lr` в URL. 5. **Limit 250 результатов** в Яндекс XML — попы