核心用法
Pinboard Manager 是一款面向技术用户的交互式书签管理技能，通过 Pinboard API 实现三大核心功能：标签审计、死链检测和时效性检查。
标签审计模式会自动抓取所有书签，依据用户自定义的标签规范（tag-convention.md）检测拼写错误、大小写不一致、中英文混用、概念重叠等问题，并以 5-10 条为批次向用户展示修复建议，经确认后批量更新。
死链检测模式使用 HTTP HEAD/GET 请求遍历所有书签 URL，识别 404、5xx 错误及超时链接，支持批量删除或保留操作，严格遵循 Pinboard 3 秒/请求的速率限制。
时效性检查模式采用"启发式预过滤 + AI 内容分析"双阶段策略：首先通过技术标签、保存时间（>2年）、版本号模式筛选候选书签，再利用 Jina Reader 抓取内容，由 Claude 评估为 outdated/possibly_outdated/still_valid 三类，推荐删除、保留或标记 evergreen，全程需用户确认。
显著优点
- 智能分层处理：时效性检查先过滤再分析，大幅降低 AI 调用成本
- 严格数据保护：所有更新操作使用
replace=yes并强制保留原书签全部字段，防止误删元数据 - 完善的速率控制：内置 3 秒间隔限制，
posts/all结果缓存 5 分钟，避免 API 封禁 - 高度可定制：首次使用生成个性化标签规范，支持中英文混合场景
潜在局限
- 依赖外部服务：需 Pinboard 付费账户（约 $22/年）及 API Token；Jina Reader 的可用性影响时效性检查
- 技术门槛：需配置环境变量，命令行操作对非技术用户不够友好
- 网络限制：部分网站会阻止 Jina Reader 抓取，导致无法评估
- 无自动执行：所有批量操作需逐批确认，大规模清理耗时较长
适合人群
- 拥有 200+ 技术书签的开发者、产品经理、技术写作者
- 需要维护长期知识库的研究人员、博主
- 习惯 Pinboard 但标签体系混乱的资深用户
常规风险
- API 限流风险：
posts/all5 分钟限制，频繁切换模式可能触发等待 - 误删风险：虽有多重确认，批量删除前建议手动备份 bookmarks.html
- Token 泄露：
PINBOARD_AUTH_TOKEN需妥善保管，避免提交至公共代码仓库