新闻API搜索

技能简介

newsapi-search 是一个基于 NewsAPI 的新闻文章检索工具，支持从5000多个新闻源中搜索文章，可按时间窗口、来源、域名和语言进行过滤。

能做什么

• 综合搜索数百万篇文章（/everything 端点）
• 获取实时头条新闻（/top-headlines 端点）
• 按小时、天、周、月或自定义日期范围过滤
• 指定可信来源或排除低质量域名
• 使用布尔语法构建复杂查询
• 列出可用的新闻源清单

使用说明

安装与配置

1. 从 newsapi.org 获取免费 API Key（每日100次请求额度）
2. 在 ~/.openclaw/.env 文件中添加：
   NEWSAPI_KEY=your_api_key

基础搜索

# 近7天技术新闻
node scripts/search.js "technology" --days 7

# 指定高质量来源
node scripts/search.js "technology" --sources bbc-news,reuters,al-jazeera-english

# 排除特定域名
node scripts/search.js "technology" --exclude tmz.com,radaronline.com

# 实时头条（美国）
node scripts/search.js "technology" --headlines --country us

# 列出可用来源
node scripts/sources.js --country us --category general

高级查询语法

• "exact phrase" — 精确匹配短语
• +musthave — 必须包含的词
• -exclude — 排除的词
• word1 AND word2 / word1 OR word2 — 布尔逻辑
• (word1 OR word2) AND word3 — 分组组合

程序化调用

const { searchEverything, searchHeadlines } = require('./scripts/search.js');

const results = await searchEverything('climate change', {
  timeWindow: { type: 'days', value: 7 },
  sources: 'bbc-news,reuters',
  excludeDomains: 'tmz.com',
  limit: 20
});

输入与输出

见下方输入与输出表格。

风险提示

• 免费版每日限制100次请求，单请求最多返回100条结果
• 归档内容存在1个月延迟
• 头条模式不支持同时指定国家/分类与来源参数
• 来源参数最多指定20个
• 需妥善保管 API Key，避免泄露导致额度被盗用

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/hegghammer/newsapi-search/SKILL.md
来源类型：GitHub 开源仓库