google-news-search

Google News 搜索

通过 Frevana 搜索 Google News。

用途

此技能用于查找 Google News 搜索结果。

输入：

• q
• 可选的 gl
• 可选的 hl
• 可选的 topic_token
• 可选的 publication_token
• 可选的 section_token
• 可选的 story_token

输出：

• 经过验证的 Google News 搜索结果 JSON

此技能会验证响应是否为 JSON，并原样返回。除非用户明确要求进行转换，否则不要改写或重塑返回的数据。

此技能所需内容

• 用户提供的 q
• 可选的 gl
• 可选的 hl
• 可选的 topic_token
• 可选的 publication_token
• 可选的 section_token
• 可选的 story_token
• 环境变量中的 FREVANA_TOKEN，或本次运行时显式指定的 --token
• curl
• bash
• python3

执行顺序

请按以下流程操作，确保请求简单可靠：

1. 确认用户已提供 q 或等效的搜索查询。
2. 优先使用脚本，而非临时编写 curl 命令。
3. 让脚本优先读取 FREVANA_TOKEN。
4. 在交互式 shell 中使用时，如果缺少 FREVANA_TOKEN，脚本可以提示用户输入。
5. 在非交互式或 Agent 工作流中，如果缺少令牌，应立即失败，并告知用户设置 FREVANA_TOKEN 或显式传入 --token。
6. 返回经过验证的响应 JSON；如果用户不需要完整内容，则总结最相关的新闻条目。
7. 在有用时，也将 JSON 保存到文件。

命令

基本新闻搜索

bash <skill-path>/scripts/search_google_news.sh \
  --q "artificial intelligence"

--query 可作为 --q 的别名。

按国家和语言搜索

bash <skill-path>/scripts/search_google_news.sh \
  --q "artificial intelligence" \
  --gl US \
  --hl en

使用 Google News 令牌搜索

bash <skill-path>/scripts/search_google_news.sh \
  --q "economy" \
  --topic-token "CAAqJggKIiBDQkFTRWdvSUwyMHZNRGcxY1Y4U0FIVnVHZ0pWVXlnQVAB"

将响应 JSON 保存到文件

bash <skill-path>/scripts/search_google_news.sh \
  --q "artificial intelligence" \
  --gl US \
  --hl en \
  --output ./out/google-news-search-result.json

覆盖本次运行的令牌

bash <skill-path>/scripts/search_google_news.sh \
  --q "artificial intelligence" \
  --token "your bearer token"

固定请求格式

脚本发送以下格式的载荷，并省略未提供的可选字段：

{
  "q": "artificial intelligence",
  "gl": "US",
  "hl": "en",
  "topic_token": "CAAq..."
}

只有 q 是必填项。用户未提供 gl、hl 或令牌值时，不要自行编造。

响应格式

API 返回 JSON。此技能会验证响应是否为 JSON，并原样返回。

输出

• 成功：脚本验证响应正文为 JSON，并将其打印到标准输出
• 使用 --output：同一份 JSON 也会写入指定的文件路径
• 失败：脚本打印响应正文或解析错误，并以非零状态退出

注意事项

• 必须指定 --q 或 --query
• 用户要求特定国家或地区时，使用 --gl
• 用户要求特定语言时，使用 --hl
• 只有用户提供了相应的 Google News 令牌时，才使用令牌字段
• 如果缺少 curl，请停止并告知用户安装 curl
• 如果缺少 python3，请停止并告知用户安装 python3
• 不要向用户回显 Bearer 令牌
• 除非用户要求完整载荷，否则只总结用户实际关心的新闻结果，不要直接倾倒原始 JSON

示例提示词

中文

• “搜索 Google News 上的 AI 新闻”
• “查一下 Google News 里 q=tesla，gl=US，hl=en”
• “用这个 topic_token 搜 Google News，并保存原始 JSON”

English

• “搜索 Google News 上的人工智能新闻”
• “查询 Google News 上 Tesla 的结果，使用 gl=US 和 hl=en”
• “使用此 topic_token 搜索 Google News，并将原始 JSON 保存到文件”