shield_lock
JinDaGe
← Back to skills
extension
Category: Data & AnalyticsAPI key required

dataify-yandex-search

Use this skill when the user wants to search Yandex

personAuthor: dataify-serverhubclawhub
open_in_newRepositorydownloadDownload package

Dataify Yandex Search

Workflow

  1. Read the user's request and map it to the API fields below.
  2. Apply defaults from the parameter descriptions only. Do not use the example YAML body as the source of defaults.
  3. Before every API call, run the bundled script with --preview and show the complete table to the user:
python3 scripts/yandex_search.py --text "<search query>" --preview
  1. Ask the user whether they want to modify any parameters. Do not call the API until the user confirms.
  2. If the user requests changes, adjust the arguments, show the complete preview table again, and ask for confirmation again.
  3. After confirmation, check the token. If the user did not provide a token and DATAIFY_API_TOKEN is not available, stop and ask the user to provide a Dataify API token or register at Dataify Dashboard.
  4. Call the API with the confirmed parameters:
python3 scripts/yandex_search.py --text "<search query>" --token "<token>"
  1. Return the script stdout directly to the user. Do not parse, summarize, translate, filter, reformat, or otherwise process the API response.

Preview Table

Always show a complete field list before calling the API. Do not include Authorization in the table. The table must contain only these columns:

  • 参数名
  • 当前值
  • 默认值
  • 说明

The bundled script generates this table with:

python3 scripts/yandex_search.py --text "<search query>" --preview

Defaults

Use these documented defaults when the user does not specify a field:

  • engine: yandex
  • json: 1
  • yandex_domain: yandex.com
  • lang: en when yandex_domain is yandex.com
  • family_mode: 1
  • fix_typo: true
  • groups_on_page: 20
  • no_cache: false

No documented default:

  • text: required from the user request.
  • lr: leave unset unless the user specifies it.
  • p: leave unset unless the user specifies it; page numbering starts from 0 when specified.

Important corrections from the API example body:

  • Do not treat example family_mode: "0" as the default. The description default is medium, so use 1.
  • Do not treat example no_cache: "true" as the default. The description says false is the default.

Field Mapping

  • --json: output format. Use 1 JSON, 2 JSON+HTML, 3 HTML, or 4 Light JSON.
  • --yandex-domain: Yandex domain such as yandex.com, yandex.ru, ya.ru, yandex.kz, yandex.com.tr, or another supported domain.
  • --lang: search language, for example en, ru, tr.
  • --lr: country or region ID.
  • --p: page number, starting from 0.
  • --family-mode: safe search mode. Use 0 off, 1 moderate, 2 strict.
  • --fix-typo: true or false.
  • --groups-on-page: maximum result groups per page.
  • --no-cache: true to bypass cache, false to use cache.
  • --params-json: JSON object of raw field overrides for unusual requests. Use null to omit a defaulted field.

For the full field list, read references/api_fields.md only when needed.

Examples

Preview parameters for a normal search:

python3 scripts/yandex_search.py --text "OpenAI latest news" --preview

After user confirmation, call the API:

python3 scripts/yandex_search.py --text "OpenAI latest news" --token "$DATAIFY_API_TOKEN"

Preview Russian Yandex, page 2, HTML output:

python3 scripts/yandex_search.py --text "artificial intelligence news" --yandex-domain yandex.ru --lang ru --p 1 --json 3 --preview