Bookmark Smart Hub Free

手动抓取社交书签并提取链接内容，基于关键词进行基础分析，适合个人单次处理。

书签智能中心 免费版

概述

免费版书签智能中心帮助个人用户从社交平台抓取收藏的书签内容，自动提取链接背后的完整文章，并基于关键词进行基础分析。用户手动触发运行，处理结果保存至本地知识库，便于后续检索与回顾。本版本适合希望整理收藏内容、建立个人知识库的独立用户。

与专业版相比，免费版聚焦手动触发与关键词分析，不包含自动化后台监控、AI 深度分析、多渠道通知与团队协作等高级能力。但两者的书签抓取接口与存储格式完全一致，便于后续平滑升级。

核心能力

能力	说明
书签抓取	从社交平台获取最新收藏的书签列表
文章全文提取	自动访问书签中的链接，提取完整文章内容
关键词分析	基于关键词匹配提取文章核心概念
本地知识库	将分析结果以 JSON 文件存入本地目录
手动触发	用户主动运行，按需处理
测试模式	预览将要处理的内容而不实际执行
技术实现要点：核心能力基于input_params参数与output_format配置实现,支持创建/查询/修改/删除等操作模式,通过config_options进行运行时配置。

核心功能执行

用input_params参数进行配置。

输入: 用户提供核心功能执行所需的指令和必要参数。 处理: 按照skill规范执行核心功能执行操作,遵循单一意图原则。 输出: 返回核心功能执行的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置。

输入: 用户提供参数配置与调用所需的指令和必要参数。 处理: 按照skill规范执行参数配置与调用操作,遵循单一意图原则。 输出: 返回参数配置与调用的执行结果,包含操作状态和输出数据。

• 执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置。

输入: 用户提供结果处理与输出所需的指令和必要参数。 处理: 按照skill规范执行结果处理与输出操作,遵循单一意图原则。 输出: 返回结果处理与输出的执行结果,包含操作状态和输出数据。

• 执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：手动抓取社交书签、并提取链接内容、基于关键词进行基、础分析、适合个人单次处理、面向个人用户的社、交书签内容提取与、基础分析工具、链接文章全文提取、本地知识库存储、手动触发运行、适用场景、个人书签整理、单次内容提取、知识碎片归档、阅读清单管理、差异化、免费版聚焦手动处、理与关键词分析、不含自动化监控与、深度分析、适用关键词、bookmark、内容提取、知识管理等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一：周末书签整理

用户每周手动运行一次，将本周收藏的社交书签批量提取并归档。

bash

# 进入工具目录
cd skills/bookmark-smart-hub

# 运行一次，处理最近的书签
npm start

输出示例

text

📚 书签处理报告
- 本次处理: 10 条书签
- 成功提取: 8 篇文章
- 提取失败: 2 条（链接已失效）
- 存储位置: ~/knowledge/bookmarks/

📄 处理明细:
1. [技术] 向量数据库入门指南 -> bookmark-001.json
2. [产品] SaaS 增长策略分析 -> bookmark-002.json
3. [设计] 极简主义 UI 设计原则 -> bookmark-003.json
...

场景二：阅读清单生成

将书签中的文章提取后，生成一份待阅读清单，按主题分类。

bash

# 测试模式，预览将要处理的内容
npm test

测试模式输出

text

🧪 测试模式（不会实际执行）
将处理以下书签:
- [技术] 理解 Transformer 注意力机制 (example.com/transformer)
- [创业] 独立开发者变现指南 (example.com/indie-monetize)
- [健康] 久坐危害与改善方案 (example.com/sitting)

预计提取: 3 篇文章
预计耗时: 约 30 秒

场景三：知识碎片归档

将散落在社交平台收藏中的有价值内容，统一提取并归档到本地知识库。

json

// ~/knowledge/bookmarks/bookmark-001.json
{
  "id": "bookmark-001",
  "source": "社交平台书签",
  "author": "@techblogger",
  "title": "向量数据库入门指南",
  "url": "https://example.com/vector-db-guide",
  "bookmarkedAt": "2026-07-15T10:30:00Z",
  "processedAt": "2026-07-18T14:00:00Z",
  "fullContent": "向量数据库是专门用于存储和检索高维向量的数据库系统...",
  "keywords": ["向量数据库", "embedding", "相似度检索", "推荐系统"],
  "summary": "介绍了向量数据库的核心概念、典型架构与适用场景",
  "priority": "medium"
}

快速开始

1. 安装依赖。

bash

cd skills/bookmark-smart-hub
npm install

2. 运行配置向导，填入社交平台凭证。

bash

npm run setup

向导将引导你完成：

• 检查必需工具是否已安装
• 配置社交平台访问凭证（auth_token 与 ct0）
• 设置存储目录
• 测试凭证有效性

3. 运行一次处理。

bash

npm start

4. 查看处理结果。

bash

ls ~/knowledge/bookmarks/
# bookmark-001.json  bookmark-002.json  ...

示例

免费版配置文件位于工具目录下的 config.json。

json

{
  "credentialsFile": ".env",
  "bookmarkCount": 20,
  "storageDir": "~/knowledge/bookmarks",
  "notifyTelegram": false,
  "analysisMode": "keyword",
  "contextProjects": [
    "个人学习笔记",
    "技术博客素材"
  ]
}

配置说明

字段	说明	默认值
bookmarkCount	每次处理的书签数量	20
storageDir	分析结果存储目录	~/knowledge/bookmarks
notifyTelegram	是否发送通知（免费版不支持）	false
analysisMode	分析模式（免费版仅 keyword）	keyword
contextProjects	个人关注领域，辅助关键词匹配	[]

凭证配置（.env 文件）

bash

AUTH_TOKEN=your_auth_token_here
CT0=your_ct0_token_here

安全提示：凭证等同于账号密码，切勿分享或提交至版本控制。.env 文件权限已设为 600（仅所有者可读写）。

最佳实践

• 定期运行：建议每周手动运行一次，避免书签堆积过多导致处理时间过长。
• 合理设置数量：bookmarkCount 建议 20-50 条，过多会触发平台限流。
• 测试先行：首次使用先运行 npm test 预览，确认无误后再正式执行。
• 项目描述具体：contextProjects 填写具体项目描述，关键词匹配更精准。
• 本地存储：结果存储在本地，建议定期备份 storageDir 目录。
• 凭证更新：社交平台凭证会过期，失效时重新获取并更新 .env 文件。
• 内容筛选：免费版基于关键词分析，结果可能不够精准，建议人工复核后归档。

常见问题

Q1：提示"凭证缺失"或"未授权"？

社交平台访问凭证已过期。重新登录平台，从浏览器开发者工具中获取最新的 auth_token 与 ct0，更新 .env 文件。

手动验证凭证

bash

cd skills/bookmark-smart-hub
source .env
bird whoami --json

若返回用户信息则凭证有效，否则需要更新。

Q2：提示"bird 命令未找到"？

需要安装 bird 命令行工具。

bash

npm install -g bird

Q3：免费版每次能处理多少书签？

免费版建议每次处理 20 条以内，每小时最多运行 1 次。bookmarkCount 可调高但可能触发平台限流。

Q4：免费版有 AI 分析吗？

免费版仅提供关键词分析（基于关键词匹配提取核心概念）。如需 AI 深度分析（概念关联、行动建议、项目关联），请升级至专业版。

Q5：提取的文章内容不完整？

部分网站有付费墙或反爬机制，可能无法提取完整内容。免费版会尽量提取可访问的内容，并在结果中标注提取状态。

Q6：如何备份数据？

直接复制 storageDir 目录即可。每个书签的分析结果都是独立的 JSON 文件，便于迁移与备份。

Q7：免费版支持自动监控吗？

不支持。免费版需手动运行。如需后台自动监控新书签并实时通知，请升级至专业版。

Q8：数据会上传到云端吗？

不会。所有数据存储在本地，仅在你主动运行时访问社交平台抓取书签和链接内容。凭证不会离开本地机器。

依赖说明

运行环境

• Agent 平台：支持 SKILL.md 的任意 AI Agent（Claude Code / Cursor / Codex / Gemini CLI 等）
• 操作系统：Windows / macOS / Linux
• 运行时：Node.js v16+

依赖详情

依赖项	类型	是否必需	获取方式
Node.js v16+	运行时	必需	nodejs.org 官方下载
bird CLI	命令行工具	必需	npm install -g bird
社交平台凭证	API 凭证	必需	浏览器开发者工具获取 auth_token 与 ct0
LLM API	API	必需	由 Agent 内置 LLM 提供

API Key 配置

• 在工具目录的 .env 文件中配置社交平台凭证（AUTH_TOKEN 与 CT0）。
• .env 文件权限自动设为 600，仅所有者可读写。
• 免费版无需额外 API Key（除社交平台凭证外）。

可用性分类

• 分类：MD+EXEC（纯 Markdown 指令，部分功能需要 exec 命令行执行能力）
• 说明：基于 Markdown 的 AI Skill，通过自然语言指令驱动 Agent 执行任务。免费版为手动处理与关键词分析功能子集，书签抓取接口与存储格式与专业版完全兼容。

错误处理

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达	执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案

已知限制

• 本地运行，不支持多设备同步