NewsAPI 搜索

通过 NewsAPI 搜索 5000+ 新闻源。支持全面的文章发现（/everything）和突发头条（/top-headlines）。

快速开始

bash

基础搜索

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

设置

将 API 密钥添加到 ~/.openclaw/.env：

NEWSAPIKEY=yourapi_key

从 https://newsapi.org 获取密钥（免费版：每天 100 次请求）

端点

全面搜索

跨数百万篇文章进行全面搜索。

时间窗口：
bash
node scripts/search.js query --hours 24
node scripts/search.js query --days 7 # 默认
node scripts/search.js query --weeks 2
node scripts/search.js query --months 1
node scripts/search.js query --from 2026-01-01 --to 2026-01-31

筛选条件：
bash
node scripts/search.js query --sources bbc-news,cnn # 最多 20 个
node scripts/search.js query --domains nytimes.com,bbc.co.uk
node scripts/search.js query --exclude gossip-site.com
node scripts/search.js query --lang en # 或 any

搜索字段：
bash
node scripts/search.js query --title-only # 仅标题
node scripts/search.js query --in title,description # 特定字段

高级查询语法：

• - 精确短语 — 精确匹配
• +必须包含 — 必需词
• -排除 — 排除词
• 词1 AND 词2 — 两者必需
• 词1 OR 词2 — 任一可接受
• (词1 OR 词2) AND 词3 — 分组

分页与排序：
bash
node scripts/search.js query --page 2 --limit 20
node scripts/search.js query --sort relevancy # 默认
node scripts/search.js query --sort date # 最新优先
node scripts/search.js query --sort popularity

头条新闻

按国家或分类获取实时突发新闻。

bash

按国家

node scripts/search.js query --headlines --country us

按分类

node scripts/search.js --headlines --country us --category business

按来源

node scripts/search.js --headlines --sources bbc-news,cnn

分类：business（商业）、entertainment（娱乐）、general（综合）、health（健康）、science（科学）、sports（体育）、technology（科技）

注意： 在头条模式下，不能同时使用 --country/--category 和 --sources。

列出来源

bash
node scripts/sources.js # 所有来源
node scripts/sources.js --country us # 按国家筛选
node scripts/sources.js --category business
node scripts/sources.js --lang en
node scripts/sources.js --json # JSON 输出

高级用法

完整参数参考，请参见 references/api-reference.md。

常见工作流程和搜索模式，请参见 references/examples.md。

编程接口

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

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

const headlines = await searchHeadlines(business, {
country: us,
category: business
});

免费版限制

• - 每天 100 次请求
• 每次请求最多 100 条结果
• 存档内容延迟 1 个月

输出格式

返回结构化的 JSON：
json
{
query: technology,
endpoint: everything,
totalResults: 64,
returnedResults: 10,
page: 1,
results: [
{
title: ...,
url: ...,
source: BBC News,
publishedAt: 2026-02-05T14:30:00Z,
description: ...,
content: ...
}
]
}