back
loading skill details...
手动抓取社交书签并提取链接内容，基于关键词进行基础分析，适合个人单次处理。
---
name: "bookmark-smart-hub-free"
description: "手动抓取社交书签并提取链接内容，基于关键词进行基础分析，适合个人单次处理。"
license: Proprietary
allowed-tools: read exec
compatibility: "Requires LLM with tool-use capability"
metadata:
displayName: "书签智能中心免费版"
version: "1.0.0"
summary: "手动抓取社交书签并提取链接内容，基于关键词进行基础分析，适合个人单次处理。"
tags:
- "书签管理"
- "内容提取"
- "知识管理"
- "个人效率"
- "阅读清单"
source: "SkillHub"
converted_at: "2026-07-22T17:58:36"
---
# 书签智能中心 免费版
## 概述
免费版书签智能中心帮助个人用户从社交平台抓取收藏的书签内容，自动提取链接背后的完整文章，并基于关键词进行基础分析。用户手动触发运行，处理结果保存至本地知识库，便于后续检索与回顾。本版本适合希望整理收藏内容、建立个人知识库的独立用户。
与专业版相比，免费版聚焦手动触发与关键词分析，不包含自动化后台监控、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命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案 |
## 已知限制
- 本地运行，不支持多设备同步
don't have the plugin yet? install it then click "run inline in claude" again.