ClawHub

Dataify Bing News

API key required
Data & APIs

Use when a user to run a Bing news search

Install

openclaw skills install dataify-bing-news

Bing News

Overview

Use this skill to turn a natural-language Bing News request into Dataify Bing News API fields, preview the full request body fields for user confirmation, call the API through scripts/bing_news.py only after confirmation, and return the API response directly to the user without summarizing, parsing, reformatting, or post-processing it.

The source API document is summarized in references/api.md. Read it when field behavior, allowed values, or response shape is unclear.

Workflow

  1. Identify the user's news query and map optional requirements to API fields:
    • engine: always bing_news. Default comes from the parameter description.
    • q: news search keywords. Default is pizza when the user does not specify a query, because the parameter description says the default is pizza.
    • json: output format. Default is 1 for JSON. Use 2 only when the user asks for JSON plus HTML. Use 3 only when the user asks for HTML.
    • mkt: display language and market, such as en-US or zh-CN. No default in the parameter description.
    • cc: two-letter country or region code, such as us, cn, jp, or uk. No default in the parameter description.
    • first: result offset. Default is 1 because the parameter description says the default is 1.
    • count: requested result count. No default in the parameter description.
    • qft: Bing query filter string for date sorting/filtering. No default in the parameter description.
    • safeSearch: Off, Moderate, or Strict. No default in the parameter description.
    • no_cache: true to bypass cache, false to use cache. Default is false because the parameter description says false is the default.
  2. Get defaults only from parameter descriptions. Do not treat YAML body examples or inline examples like mkt=en-US, cc=us, or count=10 as defaults.
  3. Prefer explicit user-provided field values over inferred values. Add optional fields without defaults only when the user clearly asks for them or provides exact field values.
  4. Use the bundled Python script with python3. Pass the whole user request through --prompt and add explicit flags for any fields that should override automatic parsing. On Windows, if python3 is not installed but python points to Python 3, use python for local execution.
  5. Before every live API call, show the complete request parameter table and ask whether the user wants to modify anything. Do not show Authorization.
    • Run --preview to print a Markdown table with exactly these columns: 参数名, 当前值, 默认值, 说明.
    • Show the table to the user and ask for confirmation.
    • If the user asks to modify values, update the fields and preview the full table again.
    • Call the API only after the user confirms the displayed parameters.
  6. Ensure authentication before a live call:
    • Read DATAIFY_API_TOKEN from the current environment.
    • If the user provides a token during the task, pass it with --token or set DATAIFY_API_TOKEN for the command before invoking the script.
    • The script adds a Bearer prefix when the token does not already include one.
    • If no token is available, ask the user to input a Dataify API token or register at Dataify Dashboard.
  7. Preview parameters before calling:
python3 scripts/bing_news.py --prompt "Search Bing news for OpenAI" --preview
  1. Run a live call only after the user confirms the previewed table:
python3 scripts/bing_news.py --prompt "Search Bing news for OpenAI"
  1. Return the script output directly to the user. Do not summarize news results, extract fields, reformat JSON, parse embedded JSON strings, or process returned HTML unless the user separately asks for processing.

Script Usage

The script supports automatic parsing plus explicit overrides:

python3 scripts/bing_news.py \
  --prompt "用必应新闻搜索 OpenAI"

Useful flags:

  • --q, --json, --mkt, --cc, --first, --count, --qft, --safeSearch, --no-cache
  • --field key=value for any supported API field
  • --token to provide a token for the current run
  • --body-format form|json, default form
  • --preview to print the full confirmation table and skip network/auth checks
  • --dry-run to print the parsed payload and skip network/auth checks
More in Data & APIs