get-tldr

📄 一键生成网页内容智能摘要

依托get-tldr.com API的链接摘要工具,一键提取网页核心内容,助力高效信息获取与阅读。

收藏
1.7k
安装
680
版本
v1.0.0
CLS 安全性认证2026-07-01
点击查看完整报告 >

使用说明

核心用法

get-tldr 是一个轻量级的链接摘要技能,通过调用 get-tldr.com 的 summarize API 服务,为用户提供快速、确定性的网页内容总结。使用时,用户只需输入 "get-tldr <链接>" 或 "get-tldr" 后跟随目标 URL,技能便会触发捆绑的 Python 脚本 get_tldr.py,将 URL 发送至 API 并返回结构化摘要结果。

该技能的核心执行流程简洁明了:脚本会向 https://www.get-tldr.com/api/v1/summarize 发送 POST 请求,携带 JSON 格式的 {"input": "<URL>"} 数据。API 返回的响应中已包含完整的摘要内容,技能仅负责提取 "summary" 字段并进行格式化处理(如去除可能的代码块包裹,确保 Markdown 正确渲染),绝不会对内容进行二次修改或删减。

配置方面,用户需要在 ~/.config/get-tldr/config.json 中配置 API Token,或通过环境变量 GET_TLDR_API_KEY、本地 .env 文件提供密钥。脚本还支持配置日志路径,默认将请求和响应记录到 ~/.config/get-tldr/skill.log,便于用户审计和排查问题。

显著优点

确定性输出:该技能定位为 "deterministic",意味着对于同一 URL,其摘要结果稳定可靠,不会因提示词工程的变化而产生差异。这种可预测性对于需要一致结果的工作流程至关重要。

格式保留能力:技能充分尊重 API 返回内容的原始格式。如果摘要本身包含 Markdown 格式,技能会确保其正确渲染而非以代码块形式展示,保证了阅读体验的流畅性。

灵活的配置机制:支持多级配置回退策略(配置文件 → 环境变量 → .env 文件),用户可以根据自身安全偏好选择最适合的密钥存储方式。日志路径也可自定义,方便集成到现有的日志管理体系中。

轻量依赖:仅依赖 Python 的 requests 库,无复杂的依赖树,部署和维护成本低。

潜在缺点与局限性

第三方服务依赖:功能完全依赖于 get-tldr.com 的可用性。若该服务出现停机、限流或停止运营,技能将无法工作。此外,API 调用需要有效的网络连接,无法在内网离线环境使用。

隐私考量:用户提交的 URL 会被发送至第三方服务器进行处理,可能暴露用户的浏览兴趣或研究方向。对于包含敏感参数的内部链接或需要身份验证的页面,不仅存在隐私泄露风险,API 也可能无法正确抓取内容。

T3 来源限制:技能由个人开发者维护(itobey),虽托管于组织仓库但缺乏大型企业或知名开源社区的背书。长期维护的稳定性、代码更新的及时性以及安全漏洞的响应速度都存在不确定性。

成本门槛:使用 get-tldr.com 服务需要用户自行申请 API Key,可能涉及费用(取决于该服务的定价策略),增加了使用门槛。

适合的目标群体

该技能特别适合学术研究人员学生,用于快速筛选大量文献和参考资料,判断文章相关性;适合市场分析师咨询顾问,高效跟踪行业动态和竞品信息;也适合内容策展者知识管理爱好者,构建个人阅读清单和知识库。对于需要处理大量网页信息但时间有限的专业人士,这是提升信息摄入效率的利器。

使用风险

数据隐私风险:URL 可能包含敏感标识符(如会话 ID、个人邮箱等),发送给第三方服务前需确保 URL 已脱敏。建议避免摘要包含个人隐私数据的页面。

日志管理风险:默认的日志记录功能会持久化存储请求和响应内容,长期运行可能导致日志文件无限增长,占用磁盘空间。建议定期清理或配置日志轮转机制。

API 依赖风险:服务的持续可用性、响应延迟(虽设置了 30 秒超时)以及可能的 API 变更都可能影响技能稳定性。建议在生产环境中使用时实现降级方案。

密钥泄露风险:虽然支持多种安全存储方式,但如果用户错误地将密钥硬编码在脚本中或提交到版本控制,仍可能导致密钥泄露。应严格遵循最小权限原则配置文件权限(如 chmod 600)。

安全解读

核心用法

get-tldr 是一款极简的链接摘要工具,专为用户快速获取网页内容精华而设计。使用时只需输入 get-tldr <URL>,skill 即调用绑定的 get_tldr.py 脚本,将 URL 发送至 get-tldr.com 的 summarize API,返回 JSON 中的 summary 字段并直接呈现。

关键机制

  • 触发模式识别 get-tldr + 链接的自然语言指令
  • 脚本读取 ~/.config/get-tldr/config.json 获取 API 密钥与日志路径,支持环境变量 GET_TLDR_API_KEY.env 文件降级
  • API 返回的摘要严禁二次加工——skill 仅做格式渲染,若原文已是 Markdown 则直接展示,移除可能的代码块包裹

显著优点

1. 确定性输出:不像 LLM 生成式摘要存在随机性,API 返回的内容固定,适合需要一致结果的场景
2. 零幻觉风险:不对内容做理解再创作,避免 AI 常见的"脑补"错误

3. 接入成本低:107 行代码、3 个文件、单依赖(requests),部署轻量

4. 配置灵活:三级密钥读取(配置文件→环境变量→.env),适应不同运维习惯

潜在缺点与局限

  • 隐私外泄:用户 URL 必须发送至第三方服务器,含敏感参数的链接存在泄露风险
  • 服务依赖:完全依赖 get-tldr.com 可用性,无本地降级摘要能力
  • 功能单一:仅能处理公开可访问的网页,不支持本地文件、需登录的内容、PDF 等非 HTML 格式
  • 日志留存:默认记录完整请求/响应,长期运行可能积累敏感浏览历史

适合人群

  • 需快速预览大量网页内容的科研人员、记者、投资者
  • 对 AI 生成摘要不信任、偏好"原文萃取"的保守用户
  • 已有 get-tldr.com 账号、愿意接受隐私-便利权衡的效率工具用户

常规风险

| 风险项 | 等级 | 说明 |
|--------|------|------|
| 数据外泄 | 中 | URL 含 token/sessionID 时会暴露给第三方 |
| SSRF 攻击 | 低 | URL 验证仅检查协议,未过滤内网地址 |
| 密钥泄露 | 低 | .env 文件可能被误提交至版本控制 |
| 日志膨胀 | 低 | 无轮转机制,长期运行磁盘占用增长 |

get-tldr 内容

手动下载zip · 2.9 kB
get_tldr.pytext/plain
请选择文件