TDK 提取接口传入一个网页 URL，自动返回该页面的 Title（标题）、Description（描述）、Keywords（关键词）三项元信息，常用于 SEO 分析、网站信息提取和竞品内容研究。把它和"网页转 Markdown"配合，就组成了一套"先粗筛、后精读"的内容分析工作流。

做 SEO 和内容运营的人，最耗时的往往不是"写"，而是"看"——看竞品排在前面的页面标题怎么起、关键词怎么埋、正文结构怎么搭。手动逐个打开网页复制粘贴，几十个页面就要一下午。

这篇文章介绍一套可脚本化的打法：用 TDK 提取做批量粗筛，用网页转 Markdown 做重点精读，把竞品内容分析从"体力活"变成"一次跑完"。文中接口均来自 SkillsBot 大模型 API（skillsbot.cn/llm-api）。

关键要点（Key Takeaways）

• TDK 提取拿元信息（标题/描述/关键词），速度快、适合批量筛查
• 网页转 Markdown 拿正文，适合对重点页面做深度内容拆解
• 组合打法：先 TDK 粗筛定位重点，再转 Markdown 精读拆结构
• 附带一个可复用的批量 Python 脚本和一份标题优化清单
• 这套流程同样适用于站点体检：快速发现缺 TDK、标题超长等问题

先理解 TDK 为什么重要

TDK 是 SEO 里最基础的三个标签：

• Title（标题）：搜索引擎结果页（SERP）的标题，也是用户点击率的第一要素
• Description（描述）：SERP 里的摘要，决定用户点不点进来
• Keywords（关键词）：页面的关键词元信息（现代搜索引擎权重已弱化，但仍可参考）

一句话：TDK 是页面给搜索引擎和用户的"第一印象"。 批量提取竞品的 TDK，能快速回答三个问题：他们在抢什么关键词？标题用了什么句式钩子？描述里埋了什么卖点？

两个接口的分工

接口	拿什么	用途	参考价
获取网站 TDK	标题 / 描述 / 关键词	批量粗筛、站点体检	0.05 元/次
网页正文转 Markdown	结构化正文	重点页面深度拆解	0.05 元/次

TDK 提取调用示例

curl -X POST 'https://www.skillsbot.cn/skillv3/api/search/tdk' \
  -H 'Authorization: Bearer {API-KEY}' \
  -H 'Content-Type: application/json' \
  -d '{"url": "https://example.com"}'

返回：

{
  "code": 20000,
  "msg": "success",
  "data": {
    "title": "示例网站标题",
    "description": "这是网站的 meta description 描述信息",
    "keywords": "关键词1, 关键词2, 关键词3"
  }
}

批量竞品分析脚本（Python）

把竞品 URL 列表一次跑完，输出一张 TDK 汇总表：

import requests
import csv

API_KEY = "YOUR_API_KEY"
URL = "https://www.skillsbot.cn/skillv3/api/search/tdk"

targets = [
    "https://competitor-a.com/page1",
    "https://competitor-b.com/page2",
    # ... 更多 URL
]

rows = []
for u in targets:
    resp = requests.post(
        URL,
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={"url": u},
    )
    d = resp.json().get("data", {})
    rows.append({
        "url": u,
        "title": d.get("title", ""),
        "description": d.get("description", ""),
        "keywords": d.get("keywords", ""),
        "title_len": len(d.get("title", "")),
    })

with open("tdk_report.csv", "w", newline="", encoding="utf-8-sig") as f:
    writer = csv.DictWriter(f, fieldnames=rows[0].keys())
    writer.writeheader()
    writer.writerows(rows)

print(f"完成 {len(rows)} 个页面的 TDK 提取，已导出 tdk_report.csv")

导出 CSV 后，用 Excel 就能按 title_len 排序，快速找出竞品里标题超长（>60 字符）或缺失描述的问题，反推自己的优化空间。

一份标题（Title）优化清单

拿到竞品 TDK 后，对照这份清单迭代自己的标题：

1. 长度控制在 60 字符内：避免 SERP 截断，核心关键词前置
2. 嵌入一个明确钩子：数字（“7 种”）、结果（“提效 3 倍”）、受众（“给开发者”）
3. 关键词自然前置：目标长尾词尽量出现在标题前 1/3
4. 与描述形成呼应：标题抛问题，描述给答案/承诺

实测经验：标题里带具体数字或明确受众的页面，点击率普遍高于纯关键词堆砌的标题。这也是为什么"XX 的 5 种方法"比"XX 方法大全"更能吸引点击。

常见问题 FAQ

TDK 提取接口和手动查看有什么区别？

手动查看要逐个打开页面、右键查看源代码、复制 meta 标签，几十个页面就要很久。接口一次调用返回结构化 JSON，可脚本化批量处理、导出表格。

Keywords 标签还有用吗？

现代搜索引擎（尤其是 Google、百度）对 meta keywords 的权重已大幅弱化甚至忽略，但它仍可作为"页面想覆盖什么词"的参考信号，用于竞品关键词研究。

批量提取会不会被封？

接口侧做了抓取处理，正常业务频率（SkillsBot 接口支持每分钟 500 次）不会被封；建议批量场景自行加限速和异常重试。

TDK 提取和网页转 Markdown 如何配合？

TDK 提取快、便宜，适合大规模粗筛；发现重点竞品页面后，再用网页转 Markdown 拿到结构化正文，拆解标题层级、内容卖点和数据支撑，做深度分析。

这套流程还适合什么场景？

除了竞品分析，还适合站点体检（批量检测缺 TDK、标题超长、描述缺失的页面）和内容迁移（把旧站内容批量转 Markdown 后重构）。

---

下一步：把上面这段脚本跑一遍，先给自己的站点做个体检，再拿竞品做一轮 TDK 对比。接口文档和扣费规则见 SkillsBot 大模型 API。