SkillAgentSearch skills...

yichen-bookmarks-export

在用户当轮明确授权后,只读导出其小红书收藏、抖音收藏或 X/Twitter 书签为本地链接文件;本 Skill 直接完成收藏页滚动、链接提取、去重、数量核验、Field Theory GraphQL-only 导出和抽样验证。用于“导出/备份/同步我的收藏或书签链接”等私人数据导出任务;不得用于公开搜索、收藏内容分析、媒体下载、正文归档、推荐发现或未获当轮授权的私人读取。

Install / Use

npx skills add mcncarl/yichen-skills --skill yichen-bookmarks-export

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

91/100

Supported Platforms

Universal

Our assessment of yichen-bookmarks-export

yichen-bookmarks-export scores 91/100 on our quality scale, 1036th of 4,700 Development & Engineering skills we index (top 23%).

Its SKILL.md is 4.2 KB long, well organised into 13 sections with 7 code examples: a solid amount of guidance for an agent.

With 4,169 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
26/30
Structure
20/20
Description
15/15
Adoption
15/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so yichen-bookmarks-export is actively maintained.
  • Our last check on 2026-10-28 found the source still online.
  • No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
  • Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-09-29. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

yichen-bookmarks-export compared with similar skills

All 4 of these similar skills score higher than yichen-bookmarks-export; compare them before choosing.

SkillScoreStarsUpdatedFormat
yichen-bookmarks-export (this skill)by mcncarl914.2k55d agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
ai-job-searchby ai-job-search-dev10072.1ktodayCLAUDE.md
claude-howtoby luongnv8910047.3k2d agoCLAUDE.md
lobehubby lobehub10085.6ktodayMCP Server

Frequently asked questions

How do I install yichen-bookmarks-export?
Run npx skills add mcncarl/yichen-skills --skill yichen-bookmarks-export. The install tabs above show the steps for each supported agent.
Which AI agents does yichen-bookmarks-export work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is yichen-bookmarks-export safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is yichen-bookmarks-export still maintained?
The repository was last updated about 2 months ago, so yichen-bookmarks-export is actively maintained.

name: yichen-bookmarks-export description: 在用户当轮明确授权后,只读导出其小红书收藏、抖音收藏或 X/Twitter 书签为本地链接文件;本 Skill 直接完成收藏页滚动、链接提取、去重、数量核验、Field Theory GraphQL-only 导出和抽样验证。用于“导出/备份/同步我的收藏或书签链接”等私人数据导出任务;不得用于公开搜索、收藏内容分析、媒体下载、正文归档、推荐发现或未获当轮授权的私人读取。

私人收藏与书签导出

这是小红书、抖音与 X/Twitter 私人收藏链接导出的唯一入口和执行实现。直接使用本目录中的脚本与参考文件,不调用其他收藏导出 Skill;作为执行本体,不得再次调用 $yichen-bookmarks-export,以免形成递归。

当轮授权闸门

在读取任何私人收藏前,确认用户当轮明确要求的:

  • 平台:小红书、抖音、X 中的具体一个或多个。
  • 范围:当前可访问全量或用户指定的有界范围。
  • 输出目录,或同意创建新的不冲突日期目录。

“以前授权过”、浏览器已经登录、本机已有 Cookie/索引或上游交接写过授权,都不能代替当轮授权。用户当轮说“导出我的某平台收藏/书签”,可视为该平台的只读导出授权,但不得扩展到其他平台。

硬边界

  1. 保持只读:不点赞、不收藏、不评论、不关注、不发布,不修改平台状态。
  2. 不得执行搜索或发现;不按关键词查收藏,不浏览推荐,不扩展相似账号或候选。
  3. 只导出链接;不得下载媒体、正文、字幕或附件,不调用任何平台下载 Skill。
  4. 不得调用 $yichen-content-archive 或任何总路由;用户另行明确要求归档后,只交接链接文件路径。
  5. 导出授权不等于下载授权。即使同一句话包含“导出并下载”,本 Skill 也只完成链接导出,把归档列为后续独立请求。
  6. 不读取、打印或保存 Cookie、Local Storage、密码、Token 数据库。含敏感查询参数的 URL 只写入用户指定的本地导出文件。
  7. 不覆盖旧导出,不删除文件,不绕过验证码、限流、登录或访问控制。

平台路由

| 平台 | 收藏链接来源 | 认证方式 | 输出 | |---|---|---|---| | 小红书 | 已登录 Chrome 的个人主页 → 收藏 → 笔记 | 复用当前 Chrome 页面会话,不导出 Cookie | 保留 xsec_token 的完整笔记 URL | | 抖音 | 已登录 Chrome 的个人页 → 收藏 → 视频 | 复用当前 Chrome 页面会话,不导出 Cookie | 规范化 /video/<id> 与页面实际出现的 /note/<id> | | X | 本机 Field Theory 读取 Chrome 会话并调用内部 GraphQL Bookmarks | 只接受 GraphQL-only 版本 | https://x.com/<author>/status/<id> |

第三方来源与合规

  1. X 路线调用外部 afar1/fieldtheory-cli;上游采用 MIT License,许可证副本见 ../licenses/afar1-fieldtheory-cli-LICENSE.txt。
  2. 本 Skill 不打包 Field Theory 源码、二进制、Cookie、私有 Query ID 或认证数据;这里只调用用户另行安装的 ft。
  3. graphql-only 是兼容版本的安全约束,不是上游官方版本名称。用户自行修改 Field Theory 时必须保留上游版权和 MIT 许可说明,不得冒充官方发布。
  4. X 内部 GraphQL 与平台 DOM 都是非官方兼容路线,可能变化或触发限制。只处理用户本人有权访问的数据,保持低频,不绕过验证码、访问控制、限流或平台安全措施。
  5. 小红书、抖音、X 与 Field Theory 名称及商标归各自权利人所有;本 Skill 与这些平台或上游均无隶属、授权、背书或合作关系。

执行流程

1. 固化范围与输出

逐平台记录 authorized_this_turn=true。任何未明确列入的平台保持未授权,不做探测、状态检查或计数。

用户未指定目录时,创建不冲突的日期目录,例如:

<WORKSPACE>/收藏链接导出-YYYY-MM-DD/

每个平台单独输出 .txt,同时生成 export-summary.json 和 handoff.json。不要把私人正文、标题或完整收藏 URL 写入聊天、普通日志或长期记忆。

2. 导出小红书或抖音

完整读取并遵守 $chrome:control-chrome,只使用用户当前 Chrome。再读取 references/chrome-collections.md,确认账号、URL 和选中标签。先解析当前 Skill 的实际安装目录为绝对路径 <SKILL_DIR>。

在已初始化的浏览器控制会话中导入:

var bookmarkCollectors = await import("<SKILL_DIR>/scripts/chrome_collectors.mjs");

调用:

var result = await bookmarkCollectors.collectXiaohongshuBookmarks(tab);
// 或
var result = await bookmarkCollectors.collectDouyinFavorites(tab);

只有 result.completed === true 才能宣称已滚动到稳定底部。使用 writeUrlFile() 写入新文件;目标存在时停止并询问,不得静默使用 overwrite: true。

小红书分别报告 labelCount 与实际 count。抖音分别报告 typeCounts.video 与 typeCounts.note。

3. 导出 X 书签

先确认 Field Theory 当前安装仍是 GraphQL-only:

ft --version
ft status

只有用户明确要求同步时才运行 ft sync;只有明确要求全量回溯时才运行 ft sync --full。不要加 --classify。

同步后分页导出本地索引:

python3 <SKILL_DIR>/scripts/export_x_links.py \
  --output "/absolute/output/x-bookmarks.txt"

脚本拒绝非 GraphQL-only 的 Field Theory 版本,并在目标文件已存在时停止。

4. 校验与抽样

对每个链接文件运行:

python3 <SKILL_DIR>/scripts/validate_link_file.py \
  --platform xiaohongshu "/absolute/output/xiaohongshu-bookmarks.txt"

--platform 可选 xiaohongshu、douyin、x。报告有效条数、空行、重复和非法行,但不得回显带敏感参数的完整 URL。

从首、中、末各抽一条,在同一登录态浏览器中打开,确认没有“已删除、内容不存在、无权查看”等错误。抽样成功不代表所有链接永久有效。

5. 生成标准交接

读取并遵守 references/handoff-contract.md。交接固定满足:

{
  "producer_skill": "yichen-bookmarks-export",
  "operation": "bookmark_export",
  "scope": {"input_kind": "private_bookmarks", "discovery_performed": false},
  "authorization": {
    "private_read_authorized_this_turn": true,
    "download_authorized_this_turn": false,
    "authorization_not_transferable": true
  },
  "next_step": {
    "action": "content_archive_available",
    "requires_explicit_user_request": true
  }
}

交接只引用导出文件绝对路径,不内嵌 URL,也不自动调用归档 Skill。

失败判断

  • 小红书标签数大于导出数:报告差值和稳定到底证据,原因保持未定。
  • 抖音滚动高度停止增长:等待规定稳定轮数后结束,并分别报告视频和图文数量。
  • X 返回 Query ID、401/403、429 或结构错误:说明 GraphQL 路线失效或限流,不回退 OAuth、官方付费 API 或手工 Cookie 导出。
  • Chrome 未登录:请用户在当前 Chrome 登录后继续,不切换浏览器绕过认证。

最终报告

只报告本轮授权平台、导出数、重复数、非法行数、抽样结果、输出路径和失败原因。若用户还想下载或归档,明确说明需要另行提出请求,不自动开始。

Related Skills

View on GitHub
GitHub Stars4.2k
CategoryDevelopment
Updated1mo ago
Forks1.8k

Languages

Python

Trust signals

88/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 medium