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
SKYWORKAPIKEY 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:
CODEBLOCK0
- - 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:
CODEBLOCK1
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
- 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
技能名称: Skywork Search
详细描述:
网页搜索技能
通过Skywork搜索API实时搜索网络信息。此技能允许单次调用最多执行3个查询,并返回包含来源URL和内容片段的结构化结果。
使用场景
- - 用户要求你研究某个主题或查找最新信息
- 你需要最新的事实、统计数据或新闻来回答问题
- 其他任务(如撰写报告、制作PPT、起草文档)需要以网络搜索作为前期步骤
- 用户明确要求搜索或查找某内容
前置条件
API密钥配置(必须优先完成)
此技能使用前需要配置
SKYWORKAPIKEY。
若尚未获取API密钥,请访问:
https://skywork.ai
详细设置说明请参阅:
references/apikey-fetch.md
使用方法
运行此技能scripts/目录下的捆绑脚本:
bash
python3 <技能路径>/scripts/web_search.py 查询1 [查询2] [查询3]
- - 传入1–3个搜索查询作为位置参数
- 结果将保存至临时目录的独立文本文件中
- 脚本会将文件路径输出到标准输出,供你读取
构建优质查询
搜索质量高度依赖查询措辞。几点建议:
- - 具体明确:特斯拉2025年第四季度营收优于特斯拉财务数据
- 使用自然语言:API能良好处理完整问题——东京当前人口是多少?完全可行
- 拆分宽泛主题:若用户需要全面概览,将其拆分为2–3个聚焦查询,而非一个模糊查询
- 包含时间背景:如2026年最佳Python Web框架而非仅最佳Python Web框架
读取结果
运行脚本后,读取输出文件。每个文件包含:
查询:<原始查询>
[结果-1] <来源URL>
<内容片段>
[结果-2] <来源URL>
<内容片段>
...
将结果整合成清晰的答案呈现给用户。提供事实信息时务必注明来源——包含结果中的URL以便用户验证。
示例工作流程
用户提问:量子计算有哪些最新进展?
- 1. 使用聚焦查询运行搜索:
bash
python3 <技能路径>/scripts/web_search.py \
2026年量子计算突破 \
量子计算行业最新新闻
- 2. 读取结果文件
- 将发现整合成清晰、有来源的摘要呈现给用户
限制条件
- - 单次调用最多3个查询(脚本已设上限)
- 每个查询有30秒超时限制
- 结果取决于Skywork搜索API的可用性