Back to Details

yandex-webmaster

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

yandex-webmaster

yandex-webmaster

Работа с Yandex Webmaster API v4. Управление сайтами, анализ индексации, поисковые запросы, переобход страниц, ссылки, фиды.
使用 Yandex Webmaster API v4 进行网站管理、索引分析、搜索查询、页面 Recrawl、链接和 Feed 管理。

Config

配置

Требуется 
YANDEX_WEBMASTER_TOKEN
в 
config/.env
. Scope: 
webmaster:hostinfo
+ 
webmaster:verify
. Инструкция: 
config/README.md
.
Для 
alice.sh
(Share of Voice, без публичного API) дополнительно нужен 
SESSION_ID
— cookie из браузера. Подробности в 
config/README.md
и references/ALICE_EFFICIENCY.md.
需要在 
config/.env
中配置 
YANDEX_WEBMASTER_TOKEN
。 Scope：
webmaster:hostinfo
+ 
webmaster:verify
。 说明：
config/README.md
。
alice.sh
（Share of Voice，无公开 API）还需要 
SESSION_ID
——浏览器中的 cookie。详情参见 
config/README.md
和 references/ALICE_EFFICIENCY.md。

Philosophy

原则

  1. Cache-first — список сайтов, user_id кешируются надолго. Отчёты кешируются по ключу host+params. Диагностика, квоты, статусы — всегда live.
  2. Context window hygiene — stdout ограничен 30 строками. Полные данные в TSV/файл. Кеш доступен через grep/rg.
  3. Host resolution — все скрипты принимают 
    --host <domain>
    (поиск по кешу hosts.tsv) или 
    --host-id <id>
    (прямой ID). Первый вызов hosts.sh автоматически кеширует список.
  4. No destructive ops — скилл не удаляет сайты, сайтмапы и фиды. Только чтение и добавление.
  1. Cache-first——网站列表和 user_id 会长期缓存。报告按 host+params 缓存。诊断、配额和状态始终使用实时数据。
  2. Context window hygiene——stdout 限制为 30 行。完整数据保存在 TSV/文件中。可通过 grep/rg 访问缓存。
  3. Host resolution——所有脚本都接受 
    --host <domain>
    （在 hosts.tsv 缓存中搜索）或 
    --host-id <id>
    （直接使用 ID）。首次调用 hosts.sh 时会自动缓存列表。
  4. No destructive ops——该 skill 不会删除网站、Sitemap 或 Feed，只执行读取和添加操作。

Workflow

工作流

STOP! Перед любым анализом:

STOP! 在进行任何分析之前：

  1. Получи список сайтов:
    bash
    bash scripts/hosts.sh
  2. Спроси пользователя (если сайт не очевиден из контекста):
    "О каком сайте идёт речь?
Укажите домен или host_id из списка."
    Для поиска по кешу:
    bash
    bash scripts/hosts.sh --search "example"
    --host
    и 
    hosts.sh --search
    принимают полный кириллический домен (например, 
    хорошие-данные.рф
    ) или URL сайта (
    https://хорошие-данные.рф/
    ). Домен автоматически преобразуется в IDNA средствами 
    python3
    ; схема и порт URL сохраняются. Латиница и готовые имена 
    xn--…
    не требуют Python. Поиск по произвольной части кириллического имени не поддерживается: указывай полный домен. В кеше и результатах остаются исходные ASCII-адреса и 
    host_id
    Яндекса.
  3. Получи сводку по сайту:
    bash
    bash scripts/summary.sh --host example.com
  4. Запускай нужные отчёты по задаче пользователя.
  1. 获取网站列表：
    bash
    bash scripts/hosts.sh
  2. 询问用户（如果上下文中无法明确判断目标网站）：
    "О каком сайте идёт речь?
Укажите домен или host_id из списка."
    按缓存搜索：
    bash
    bash scripts/hosts.sh --search "example"
    --host
    和 
    hosts.sh --search
    接受完整的西里尔字母域名（例如 
    хорошие-данные.рф
    ）或网站 URL（
    https://хорошие-данные.рф/
    ）。 域名会通过 
    python3
    自动转换为 IDNA；URL 的 scheme 和 port 会保留。 拉丁字母域名和现成的 
    xn--…
    名称无需 Python 处理。 不支持按西里尔字母名称的任意片段搜索：请提供完整域名。缓存和结果中会保留原始 ASCII 地址及 Yandex 的 
    host_id
    。
  3. 获取网站摘要：
    bash
    bash scripts/summary.sh --host example.com
  4. 根据用户任务运行相应报告。

Scripts

脚本

Общий паттерн вызова:
bash
bash scripts/<script>.sh --host <domain> [--action <action>] [params...]
通用调用模式：
bash
bash scripts/<script>.sh --host <domain> [--action <action>] [params...]

Управление сайтами

网站管理

ScriptDescriptionKey params
hosts.sh
Список сайтов
--search "text"
, 
--no-cache
host_info.sh
Инфо о сайте + владельцы—
add_site.sh
Добавить сайт
--url <url>
verify.sh
Верификация сайта
--action get|start
, 
--method DNS|HTML_FILE|META_TAG
Script描述关键参数
hosts.sh
网站列表
--search "text"
, 
--no-cache
host_info.sh
网站信息和所有者—
add_site.sh
添加网站
--url <url>
verify.sh
验证网站
--action get|start
, 
--method DNS|HTML_FILE|META_TAG

Статистика сайта

网站统计

ScriptDescriptionKey params
summary.sh
Сводка: SQI, страницы, проблемы—
sqi_history.sh
История SQI
--date-from
, 
--date-to
diagnostics.sh
Проблемы сайта (live)—
Script描述关键参数
summary.sh
摘要：SQI、页面数、问题—
sqi_history.sh
SQI 历史
--date-from
, 
--date-to
diagnostics.sh
网站问题（实时）—

Поисковые запросы

搜索查询

ScriptDescriptionKey params
popular_queries.sh
Топ запросов
--order-by
, 
--device
, 
--limit
queries_history.sh
История запросов
--query-id
(опц.), 
--device
query_analytics.sh
Расширенная аналитика (POST)
--text-indicator
, 
--filter-*
, 
--region-ids
Script描述关键参数
popular_queries.sh
热门查询
--order-by
, 
--device
, 
--limit
queries_history.sh
查询历史
--query-id
（可选）, 
--device
query_analytics.sh
扩展分析（POST）
--text-indicator
, 
--filter-*
, 
--region-ids

Индексация

索引

ScriptDescriptionKey params
indexing.sh
История/сэмплы индексации
--action history|samples
important_urls.sh
Важные URL
--action list|history
, 
--url
archive_export.sh
Экспорт всех страниц
--action start|status
, 
--task-id
Script描述关键参数
indexing.sh
索引历史/样本
--action history|samples
important_urls.sh
重要 URL
--action list|history
, 
--url
archive_export.sh
导出所有页面
--action start|status
, 
--task-id

Страницы в поиске

搜索结果中的页面

ScriptDescriptionKey params
insearch.sh
Страницы в выдаче
--action history|samples
search_events.sh
Появление/исчезновение
--action history|samples
Script描述关键参数
insearch.sh
搜索结果中的页面
--action history|samples
search_events.sh
出现/消失
--action history|samples

Переобход

Recrawl

ScriptDescriptionKey params
recrawl.sh
Переобход URL
--action submit|status|list|quota
, 
--url
, 
--task-id
Script描述关键参数
recrawl.sh
URL Recrawl
--action submit|status|list|quota
, 
--url
, 
--task-id

Ссылки

链接

ScriptDescriptionKey params
internal_links.sh
Битые внутренние ссылки
--action samples|history
, 
--indicator
external_links.sh
Внешние ссылки
--action samples|history
Script描述关键参数
internal_links.sh
失效的内部链接
--action samples|history
, 
--indicator
external_links.sh
外部链接
--action samples|history

Сайтмапы

Sitemap

ScriptDescriptionKey params
sitemaps.sh
Управление сайтмапами
--action list|user-list|info|add|recrawl-limit|recrawl
Script描述关键参数
sitemaps.sh
Sitemap 管理
--action list|user-list|info|add|recrawl-limit|recrawl

Alice / Share of Voice (SSR scraping)

Alice / Share of Voice（SSR scraping）

ScriptDescriptionKey params
alice.sh
Эффективность в Алисе: SoV timeline, конкуренты, запросы где сайт есть/нет
--action summary|sov|competitors|with-site|without-site|fetch
, 
--no-cache
⚠ Нет публичного API — данные парсятся из 
window._initData
HTML-страницы. Для загрузки нужен 
SESSION_ID
cookie в 
config/.env
. Корректный кеш используется 24 часа без загрузки страницы; 
--no-cache
и 
--action fetch
обновляют его принудительно. Если обновление не удалось, команда завершается с ошибкой, сохраняя прежний JSON. Диагностика и повторы: references/ALICE_EFFICIENCY.md.
Script描述关键参数
alice.sh
Alice 效率：SoV 时间线、竞争对手、网站出现/未出现的查询
--action summary|sov|competitors|with-site|without-site|fetch
, 
--no-cache
⚠ 没有公开 API——数据通过 scraping 从 
window._initData
HTML 页面中获取。 加载数据需要在 
config/.env
中设置 
SESSION_ID
cookie。有效缓存可在不加载页面的情况下使用 24 小时；
--no-cache
和 
--action fetch
会强制刷新缓存。 如果刷新失败，命令将报错退出，并保留之前的 JSON。 诊断和重试：references/ALICE_EFFICIENCY.md。

Фиды и PRO

Feed 和 PRO

ScriptDescriptionKey params
feeds.sh
YML-фиды
--action list|add|change|add-status
, 
--type
, 
--region-ids
search_export.sh
PRO SERP экспорт
--action dates|limits|start|status
regions.sh
Справочник регионов
--filter "москва"
Script描述关键参数
feeds.sh
YML Feed
--action list|add|change|add-status
, 
--type
, 
--region-ids
search_export.sh
PRO SERP 导出
--action dates|limits|start|status
regions.sh
地区参考表
--filter "москва"

Общие параметры

通用参数

ParamDescription
--host <domain>
Домен/URL сайта (поиск по hosts.tsv)
--host-id <id>
Прямой host_id (формат: 
http:example.com:80
)
--action <act>
Подкоманда скрипта
--date-from
Начало периода YYYY-MM-DD (history: default 90 дней назад)
--date-to
Конец периода YYYY-MM-DD
--limit N
Число записей
--offset N
Смещение
--no-cache
Пропустить кеш
参数描述
--host <domain>
网站域名/URL（在 hosts.tsv 中搜索）
--host-id <id>
直接指定 host_id（格式：
http:example.com:80
）
--action <act>
脚本子命令
--date-from
周期开始日期 YYYY-MM-DD（history：默认从 90 天前开始）
--date-to
周期结束日期
--limit N
记录数量
--offset N
偏移量
--no-cache
跳过缓存

Кеш-стратегия

缓存策略

Кеш в 
cache/
:
  • user_id.txt
    — ID пользователя (permanent)
  • hosts.json
    + 
    hosts.tsv
    — список сайтов (permanent, инвалидируется при add/verify)
  • host_*/queries/*.tsv
    — результаты запросов (session, hash-keyed)
  • host_*/indexing/*.tsv
    — данные индексации (session)
  • host_*/insearch/*.tsv
    — данные о поиске (session)
  • host_*/links/*.tsv
    — данные о ссылках (session)
  • host_*/alice/init.json
    — проверенный объект Alice, общий для всех действий 
    alice.sh
    , срок кеша — 24 часа
  • host_*/alice/raw.html
    — последний полностью полученный HTML для диагностики, без истории версий
  • Диагностика, квоты, статусы переобхода — не кешируются (always live)
缓存位于 
cache/
：
  • user_id.txt
    ——用户 ID（永久）
  • hosts.json
    + 
    hosts.tsv
    ——网站列表（永久缓存，在添加/验证时失效）
  • host_*/queries/*.tsv
    ——查询结果（session 级缓存，按 hash 生成键）
  • host_*/indexing/*.tsv
    ——索引数据（session）
  • host_*/insearch/*.tsv
    ——搜索数据（session）
  • host_*/links/*.tsv
    ——链接数据（session）
  • host_*/alice/init.json
    ——已验证的 Alice 对象，供 
    alice.sh
    的所有操作共用，缓存有效期为 24 小时
  • host_*/alice/raw.html
    ——最近一次完整获取的 HTML，用于诊断，不保留版本历史
  • 诊断、配额、Recrawl 状态——不缓存（始终实时）

Расширенные сценарии

扩展场景

  • Добавление и верификация сайтов
  • Поисковые запросы и аналитика
  • Управление сайтмапами
  • Статистика сайта и индексация
  • Страницы в поиске
  • Переобход страниц
  • Битые внутренние ссылки
  • Внешние ссылки
  • YML-фиды
  • PRO SERP экспорт
  • Alice / Share of Voice (scraping)
  • Расписание врачей (спецификация)
  • 网站添加与验证
  • 搜索查询与分析
  • Sitemap 管理
  • 网站统计与索引
  • 搜索结果中的页面
  • 页面 Recrawl
  • 失效的内部链接
  • 外部链接
  • YML Feed
  • PRO SERP 导出
  • Alice / Share of Voice（scraping）
  • 医生排班（规范）

Лимиты API

API 限制

  • Query Analytics: 10 000 запросов/час на домен
  • Скрипты автоматически обрабатывают 429 (Retry-After ≤ 60s → retry, иначе fail)
  • Лимит сайтов: 1703 на аккаунт
  • Лимит фидов: 5000 на сайт, 50 в batch
  • Лимит export: макс. 100 комбинаций дат+URL
  • Query Analytics：每个域名每小时 10,000 次请求
  • 脚本会自动处理 429（
    Retry-After ≤ 60s
    → 重试，否则失败）
  • 网站数量限制：每个账户 1,703 个网站
  • Feed 数量限制：每个网站 5,000 个，每批 50 个
  • export 限制：最多 100 个日期+URL 组合