360 Secure SkillHub
360 安全技能中心

Skywork Search

调用 Skywork Search API 的 Python 脚本:一次最多传入 3 条搜索查询,脚本将含来源 URL 与内容摘录的结果写入临时文本文件并输出路径,供用户查询实时信息、引用来源;使用前必须配置 SKYWORK_API_KEY。

gxcun17
gxcun17
热度 90.72
最近更新 2026-05-11 17:32:28
分类:搜索依赖:代码执行 / 第三方 API / 读写文件应用场景:研究

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add skywork-search
Metadata
name
Skywork Search
description
Skywork Search (skywork) - Search the web for real-time information using the Skywork Search API. Use this skill whenever the user needs up-to-date information from the internet — for example, researching a topic, looking up recent events, finding facts or statistics, gathering material for a document or presentation, or answering questions that require current data. Also trigger when the user says things like "search for" / "搜索" / "検索" / "검색", "look up" / "查询" / "調べる" / "조회하다", "find information about" / "查找关于……的信息" / "……に関する情報を探す" / "…에 대한 정보를 찾다", "what's the latest on" / "……最新进展" / "……の最新情報" / "…의 최신 소식", or any request that implies needing information beyond your training data.
metadata
{"openclaw":{"requires":{"bins":["python3"],"env":["SKYWORK_API_KEY"]},"primaryEnv":"SKYWORK_API_KEY"}}

Web Search Skill

Search the web for real-time information via the Skywork search API. This skill lets you run up to 3 queries in a single invocation and returns structured results with source URLs and content snippets.

When to use

  • The user asks you to research a topic or find current information
  • You need up-to-date facts, statistics, or news to answer a question
  • Another task (writing a report, creating a PPT, drafting a document) needs web research as a preliminary step
  • The user explicitly asks to search or look something up

Prerequisites

API Key Configuration (Required First)

This skill requires a SKYWORK_API_KEY to be configured before use.

If you don't have an API key yet, please visit: https://skywork.ai

For detailed setup instructions, see: references/apikey-fetch.md

How to use

Run the bundled script from this skill's scripts/ directory:

python3 <skill-path>/scripts/web_search.py "query1" ["query2"] ["query3"]
  • Pass 1–3 search queries as positional arguments
  • Results are saved to individual text files in a temporary directory
  • The script prints the file paths to stdout so you can read them

Crafting good queries

Search quality depends heavily on query phrasing. A few tips:

  • Be specific: "Tesla Q4 2025 revenue" works better than "Tesla financials"
  • Use natural language: The API handles full questions well — "What is the current population of Tokyo?" is fine
  • Split broad topics: If the user wants a comprehensive overview, break it into 2–3 focused queries rather than one vague one
  • Include time context when relevant: "best Python web frameworks 2026" rather than just "best Python web frameworks"

Reading results

After running the script, read the output files. Each file contains:

query: <the original query>

[result-1] <source URL>
<content snippet>

[result-2] <source URL>
<content snippet>
...

Synthesize the results into a clear answer for the user. Always cite sources when presenting factual information — include the URLs from the results so the user can verify.

Example workflow

User asks: "What are the latest developments in quantum computing?"

  1. Run the search with focused queries:
    python3 <skill-path>/scripts/web_search.py \
      "quantum computing breakthroughs 2026" \
      "quantum computing industry news latest"
    
  2. Read the result files
  3. Synthesize findings into a clear, sourced summary for the user

Limitations

  • Maximum 3 queries per invocation (the script caps it)
  • Each query has a 30-second timeout
  • Results depend on the Skywork search API availability