- name
- find-news
- description
- |
Find News 技能
概述
这个技能提供多引擎搜索能力，通过调用官方 API 实现快速搜索。开箱即用，跨平台支持（Windows/Mac/Linux）。
API 接口
搜索接口
端点: POST http://36.151.144.35:3001/api/v1/search
认证: Bearer sk_test_a6f84bf78896f10b2d28aebd7857744c
请求参数:
query(string, 必需): 搜索关键词search_service(string, 必需): 搜索服务名称
- baidu: 百度搜索 - google: Google 搜索 - bing: Bing 搜索 - duckduckgo: DuckDuckGo - yahoo: Yahoo 搜索 - wechat: 微信公众号 - youtube: YouTube - github: GitHub - reddit: Reddit - bilibili: 哔哩哔哩
max_results(number, 可选): 返回结果数量 (1-20, 默认 3)crawl_results(number, 可选): 爬取完整内容的结果数 (0-10, 默认 0)
- 0: 只返回搜索摘要（快速） - 1-10: 爬取完整页面内容（慢，成本高）
请求示例:
{
"query": "人工智能",
"search_service": "baidu",
"max_results": 5,
"crawl_results": 0
}响应示例:
{
"results": [
{
"title": "搜索结果标题",
"url": "https://example.com",
"snippet": "搜索结果摘要...",
"content": "完整内容（仅当 crawl_results > 0 时）"
}
],
"total": 5,
"cached": false
}新闻接口
端点: POST http://36.151.144.35:3001/api/v1/news
认证: Bearer sk_test_a6f84bf78896f10b2d28aebd7857744c
请求参数:
query(string, 必需): 搜索关键词search_service(string, 可选): 新闻服务名称
- google (默认): Google News - bing: Bing News - duckduckgo: DuckDuckGo News - yahoo: Yahoo News
max_results(number, 可选): 返回结果数量 (1-20, 默认 3)crawl_results(number, 可选): 爬取完整内容的结果数 (0-10, 默认 0)
请求示例:
{
"query": "科技新闻",
"search_service": "google",
"max_results": 10,
"crawl_results": 0
}使用场景
场景 1: 快速获取搜索摘要（默认，推荐）
用户: "帮我搜索一下最新的 AI 新闻"
Agent 操作: 发送 POST 请求到新闻接口
{
"query": "AI",
"search_service": "google",
"max_results": 5,
"crawl_results": 0
}→ 返回 5 条新闻标题和摘要（快速，0.5秒，每条 10 积分）
场景 2: 深度内容抓取（仅在必要时使用）
用户: "我需要这篇文章的完整内容"
Agent 操作: 发送 POST 请求到搜索接口
{
"query": "文章标题",
"search_service": "baidu",
"max_results": 1,
"crawl_results": 1
}→ 返回完整页面内容（慢，10-30秒，成本 10 积分）
场景 3: 多平台搜索
用户: "在微信公众号和 B 站搜索'Python 教程'"
Agent 操作: 发送两个 POST 请求
请求 1 - 微信公众号:
{
"query": "Python教程",
"search_service": "wechat",
"max_results": 5,
"crawl_results": 0
}请求 2 - 哔哩哔哩:
{
"query": "Python教程",
"search_service": "bilibili",
"max_results": 5,
"crawl_results": 0
}场景 4: GitHub 代码搜索
用户: "搜索 GitHub 上的 react hooks 相关项目"
Agent 操作: 发送 POST 请求
{
"query": "react hooks",
"search_service": "github",
"max_results": 10,
"crawl_results": 0
}场景 5: YouTube 视频搜索
用户: "在 YouTube 上搜索编程教程"
Agent 操作: 发送 POST 请求
{
"query": "programming tutorial",
"search_service": "youtube",
"max_results": 5,
"crawl_results": 0
}定价
- 每个搜索结果：10 积分
- 缓存命中：免费（30 分钟内相同查询）
- 相同查询 30 分钟内第二次调用免费
⚠️ 重要提示
性能
crawl_results=0（默认）：0.5-2 秒crawl_results=1-10：每个结果增加 10-30 秒
成本
- 每个搜索结果：10 积分
- 缓存命中：免费（30 分钟内相同查询）
- 建议：优先使用摘要，只在必要时抓取完整内容
最佳实践
- 默认使用
max_results: 3, crawl_results: 0（快速获取摘要） - 只有用户明确要求"完整内容"时 才设置
crawl_results > 0 - 搜索前 先检查是否有缓存（相同查询 30 分钟内免费）
- 合理控制数量
max_results不要设置过大，避免不必要的成本
注意事项
- 默认使用
crawl_results: 0以获得快速响应 - 设置
crawl_results > 0会显著增加延迟（10-30秒/页） - 注意控制请求频率，避免超出限流
- 相同查询 30 分钟内会使用缓存，免费且更快
- 所有请求必须在 Header 中包含
Authorization: Bearer sk_test_a6f84bf78896f10b2d28aebd7857744c - Content-Type 必须设置为
application/json
错误处理
常见错误码：
400: 请求参数错误401: 认证失败（API Key 无效）429: 请求频率超限500: 服务器内部错误
建议在请求失败时进行重试，最多重试 3 次。