# 水土保持新闻查询 Skill（shuibao-news）

让 AI Agent 查询"水土保持公示网"（www.yanshou100.com）收录的水土保持行业公开新闻。数据覆盖水利部、各省水利厅、地市区县水保部门和行业公众号的公开动态。

基础能力长期保持**匿名、只读、免费**，无需 API Key、无需注册。

## 你将获得的能力

- 查询最新收录的水土保持新闻
- 按标题关键词搜索新闻
- 按来源分组筛选：全国性来源 / 各省水利厅 / 地市区县 / 行业公众号

## 查询接口

基础地址：`https://www.yanshou100.com`

### 1. 最新新闻

```
GET /api/v1/news/latest
```

| 参数 | 必填 | 说明 |
| --- | --- | --- |
| `limit` | 否 | 返回条数，整数，默认 20，最大 100 |
| `sourceGroup` | 否 | 来源分组，取值见下表 |

### 2. 关键词搜索

```
GET /api/v1/news/search
```

| 参数 | 必填 | 说明 |
| --- | --- | --- |
| `keyword` | 是 | 标题搜索关键词，为空返回 400 |
| `limit` | 否 | 同上 |
| `sourceGroup` | 否 | 同上 |

### sourceGroup 取值

| 取值 | 含义 |
| --- | --- |
| `national` | 全国性来源（水利部及其直属机构） |
| `regional_sources` | 各省水利厅 |
| `local_sites` | 地市区县动态 |
| `public_accounts` | 行业公众号 |

两个接口均按发布时间倒序返回，**只返回第一页**。

## 返回结构

```json
{
  "items": [
    {
      "id": 141682,
      "title": "省水利厅关于某生产建设项目水土保持方案的批复",
      "publishTime": "2026-07-29",
      "url": "https://example.com/news/141682.html",
      "from": "湖北省水利厅",
      "province": "湖北",
      "provinceName": "湖北",
      "city": "湖北",
      "cityName": "湖北",
      "spiderTime": "2026-07-30 01:10:28",
      "createTime": "2026-07-30 01:10:28"
    }
  ],
  "total": 94910,
  "limit": 20,
  "page": 1,
  "sourceGroup": "",
  "sortMode": "latest"
}
```

| 字段 | 说明 |
| --- | --- |
| `items[].title` | 新闻标题 |
| `items[].publishTime` | 原网站发布日期，`YYYY-MM-DD` |
| `items[].url` | 新闻原文链接 |
| `items[].from` | 来源名称，如"水利部""湖北省水利厅" |
| `items[].province` / `provinceName` | 省份 |
| `items[].city` / `cityName` | 地市 |
| `items[].spiderTime` / `createTime` | 本站收录时间，`YYYY-MM-DD HH:mm:ss` |
| `total` | 当前筛选条件下的新闻总数 |

## 使用规则

1. **免费匿名只读**：不需要任何密钥或登录，直接发起 HTTP GET 请求即可。
2. **数量上限**：单次最多 100 条、仅第一页。用户需要更多时，如实说明上限，不要虚构数据。
3. **时间过滤**：接口不支持时间范围参数。用户问"最近一周""今天"时，取回结果后按 `publishTime` 自行筛选，并如实说明这是按日期过滤后的结果。
4. **呈现要求**：向用户展示新闻时，请包含**标题、来源（from）、发布日期（publishTime）和原文链接（url）**。
5. **信息核对**：标题与来源来自公开网站抓取。用户要引用数字、政策原文时，提醒其点击原文链接核对。
6. **能力边界**：本站不提供新闻摘要、主题分类、热点排行、日报等能力；不要编造这些内容。

## 用户问题到调用的映射示例

| 用户问法 | 调用 |
| --- | --- |
| "最近有什么水土保持新闻/动态" | `GET /api/v1/news/latest?limit=10` |
| "搜一下水土保持方案相关的新闻" | `GET /api/v1/news/search?keyword=水土保持方案` |
| "看看各省水利厅的动态" | `GET /api/v1/news/latest?sourceGroup=regional_sources&limit=10` |
| "行业公众号最近发了什么" | `GET /api/v1/news/latest?sourceGroup=public_accounts` |
| "过去一周湖北的新闻" | `GET /api/v1/news/search?keyword=湖北`，再按 `publishTime` 过滤 |

## 回答呈现示例

> 1. 《省水利厅关于某项目水土保持方案的批复》 — 湖北省水利厅，2026-07-29，[原文链接](https://example.com/news/141682.html)
> 2. 《水利部关于进一步加强生产建设项目水土保持监管的通知》 — 水利部，2026-07-28，[原文链接](https://example.com/news/141680.html)

---

接入说明页：<https://www.yanshou100.com/news/news-agent.html>
MCP 接入页：<https://www.yanshou100.com/news/news-mcp.html>
