# 文本关键词抽取：新闻摘要与热点提取实战
- **接口 / 接入点**：文本关键词抽取（apiCode 941）· 接入点 `941-1`
- **是否免费**：是 ｜ **请求方式**：POST / GET ｜ **返回格式**：JSON
- **适用人群**：内容运营、编辑、产品经理
- **阅读时间**：约 8 分钟
## 核心要点
- 链路：正文清洗 → 调接口取 Top-N 关键词 → 生成摘要标签 / 专题聚合。
- `num` 控制关键词数量，长文可适当调大（默认 10）。
- 关键词用于自动打标、专题归类与检索，省去人工读全文。
## Why：新闻运营的真实痛点
新闻 / 资讯类站点每天产出大量文章，人工写摘要、打标签既慢又标准不一。用文本关键词抽取，每篇正文一键产出代表主题的关键词，自动挂到标签页、专题页与站内搜索，编辑只需做轻量校对。
## What：前置条件与接口速览
同本系列[快速接入指南](https://www.showapi.com/guides/text-keyword-quickstart-941)：需 AppKey、免费调用、路由 `https://route.showapi.com/941-1?appKey=YOUR_APPKEY`，参数 `text`（必填）、`num`（可选）。
## How：从正文到关键词标签
### 步骤 1 · 清洗正文
去掉 HTML 标签、广告段、导航与版权行，只保留正文文本：
```python
import re
def clean_html(raw):
txt = re.sub(r"<[^>]+>", "", raw) # 去标签
txt = re.sub(r"\s+", " ", txt).strip() # 合并空白
return txt
```
### 步骤 2 · 抽取关键词
```python
import requests
def keywords(text, appkey, num=10):
r = requests.post("https://route.showapi.com/941-1",
data={"appKey": appkey, "text": text, "num": str(num)}, timeout=10)
data = r.json()
body = data.get("showapi_res_body", {})
if str(body.get("ret_code")) == "0":
return body.get("list", [])
return [] # 失败兜底：返回空，由上层决定是否重试
article = clean_html(raw_html)
tags = keywords(article, "YOUR_APPKEY", num=8)
print("本文标签：", tags)
```
### 步骤 3 · 生成摘要标签与专题聚合
把 `tags` 写入文章的 meta keywords、标签页与专题库：
```python
# 伪代码：写入内容与专题
save_article_meta(article_id, meta_keywords=tags)
for tag in tags:
add_to_topic(tag, article_id) # 同一关键词聚到同一专题
```
## 返回示例与解析
成功返回 `list` 为文章主题词数组，如 `["测试","文字"]`（示例）。真实长文会返回更有区分度的词，直接用作标签即可。
## 进阶 / 边界
- 停用词前置：可在调用前去掉「的/了/是」等高频无意义词，提升关键词质量（接口本身已做词频处理，前置去停用词是锦上添花）。
- 长文切片：超长正文建议按段落切片分别抽取再合并去重，避免单段噪声。
- 结果仅供参考：关键词是统计相关性产物，重要但可能漏掉长尾主题，编辑应对重点文章做校对。
## FAQ
**Q1：一篇新闻取几个关键词合适？**
A1：默认 10，实际 5~8 个做标签较清爽；专题聚合可取到 10~15。文档未给硬上限，按阅读体验定。
**Q2：关键词能直接当摘要用吗？**
A2：关键词是主题词，不是句子级摘要。可组合成「标签云」或作为摘要的辅助，完整摘要仍需另行生成。
**Q3：同一专题怎么聚合？**
A3：以关键词为聚合键，把含相同关键词的文章归入同一专题页，站内搜索也能复用。
**Q4：免费接口能支撑新闻站点量级吗？**
A4：免费有使用档次限制。高频场景务必做缓存与档位规划，见[缓存与限流策略](https://www.showapi.com/guides/text-keyword-cache-cost-941)。
**Q5：num 调大关键词会变多但质量下降吗？**
A5：可能。靠后的词相关性通常更低，建议取前 N 个高质量词，其余丢弃。
## 相关能力 / 下一步阅读
- [文本关键词抽取：SEO 标签与内链自动生成实战](https://www.showapi.com/guides/text-keyword-seo-tags-941) —— 标签如何反哺 SEO
- [文本关键词抽取：TextRank 算法原理与 num 参数调优](https://www.showapi.com/guides/text-keyword-textrank-tuning-941) —— 为什么这些词能代表主题
- **本系列共 10 篇**：查看[文本关键词抽取指南总目录](https://www.showapi.com/guides/text-keyword-guides-941)
