pdsx

一个通用的ATProto协议记录操作命令行工具,支持CRUD、批量操作和MCP集成。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:pdsx。
它的用途是:一个通用的ATProto协议记录操作命令行工具,支持CRUD、批量操作和MCP集成。
完整的 Skill 内容见:https://321skill.com/skills/pdsx/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“使用pdsx查看用户@example.bsky.social最近发布的帖子内容。”,它会通过MCP工具调用pdsx的查询功能,获取并返回该用户的帖子记录。或者,

对AI说:“我需要批量删除我账号下所有2023年之前的旧帖子。”,它可以指导你编写脚本,通过pdsx CLI的`rm`命令配合JSONL输入文件来高效、并发地完成此任务。

介绍

pdsx是一个专为ATProto协议设计的通用命令行工具,用于对Bluesky等社交网络的数据记录进行创建、读取、更新和删除操作。它解决了开发者和研究人员需要直接、高效地与ATProto数据存储交互的需求。

使用上,pdsx主要通过命令行调用,支持多种安装方式(如uv、uvx),并提供了ls、get、edit、rm等类Unix风格的命令别名来操作记录。它支持JSON、YAML等多种输出格式,便于脚本处理。

该工具非常适合需要自动化处理ATProto记录、进行批量数据操作(如清理、迁移)、或为AI智能体(通过MCP协议)提供数据访问能力的开发者、数据分析师和智能体开发者。

使用建议:对于常规的单一记录CRUD操作,推荐使用其集成的MCP工具,以获得结构化输出并与AI工作流集成。对于需要并发处理的批量操作、Blob文件上传或探索实验性功能(如Spaces),则应直接使用CLI。注意,读取操作始终需要明确指定目标仓库(-r参数),即使已认证。

核心特点

核心区别在于它不仅是命令行工具,还原生集成了MCP服务器,能将ATProto记录操作能力直接暴露给AI智能体使用;同时,它提供了对批量并发操作和Blob上传的专门支持,这在同类工具中不常见。

注意事项

不适合需要完全图形化界面操作或仅进行简单、一次性手动交互的用户。

常见问题

安装时为什么需要--prerelease=allow参数?

因为pdsx依赖的fastmcp库目前是4.0.0a1预发布版本,包管理器默认跳过预发布版,不加此参数会错误安装旧版本。

MCP工具和CLI命令行该如何选择?

单一记录CRUD和只读查询用MCP工具;批量操作、Blob上传、使用实验性Spaces功能时用CLI。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/pdsx/raw/index.md 读取 pdsx 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。