xurl
一个类似curl的命令行工具，用于调用X（原Twitter）API。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：xurl。 它的用途是：一个类似curl的命令行工具，用于调用X（原Twitter）API。 完整的 Skill 内容见：https://321skill.com/skills/xurl/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“用xurl帮我发一条推文，内容说‘测试一下新工具’。”，AI会在确认用户已手动完成认证后，执行类似 `xurl post '测试一下新工具'` 的命令并返回结果。或者，用户可以说：“搜索最近24小时内包含‘AI Agent’的推文。”，AI会使用 `xurl search 'AI Agent' --recent` 等命令进行查询。
介绍
xurl 是一个专为X（原Twitter）API设计的命令行工具，它解决了开发者和自动化脚本需要与X平台进行复杂交互（如发帖、搜索、私信、管理媒体等）但不想编写繁琐HTTP请求的问题。
它通过提供类似curl的简洁语法和更友好的快捷命令，让用户能轻松调用X API v2的所有端点。使用前，用户需在本地机器上手动配置认证信息（如OAuth密钥），确保敏感凭证不会泄露给AI会话。配置完成后，即可通过xurl命令执行各种操作，所有结果均以JSON格式返回，便于程序化处理。
该工具主要适合开发者、自动化工程师、社交媒体运营或研究人员，他们需要在脚本、CI/CD流水线或后台服务中集成X平台的功能。对于普通终端用户，如果仅需偶尔手动操作，官方客户端或网页可能更直观。
与同类工具（如直接使用curl调用API或使用其他Twitter SDK）相比，xurl的核心优势在于其“双模式”设计：既保留了curl式的灵活性和对原始端点的完全控制，又封装了大量高频操作为易用的快捷命令（如发推、搜索），降低了使用门槛。同时，它严格区分了在AI Agent环境与手动环境下的安全操作规范，强调了凭证隔离与保护。
核心特点
xurl 提供了“快捷命令”与“原始curl式访问”双模式，既能像高级SDK一样用简单命令完成发推、搜索等常见任务，又能像底层HTTP工具一样灵活调用任何X API v2端点。同时，它强制实施了严格的AI会话安全规范，明确禁止在LLM上下文中处理任何认证密钥，从设计上避免了凭证泄露风险。
注意事项
不适合需要在AI Agent会话中直接进行初始OAuth认证或处理敏感密钥的场景，所有认证步骤必须由用户在终端手动完成。
常见问题
xurl 能用来做什么？
可以发推、回复、引用、搜索帖子、管理关注者、发送私信、收发端到端加密的XChat消息、上传媒体，以及调用任何X API v2端点。
在AI助手（如Claude）里能用xurl吗？
可以使用已认证后的xurl执行非敏感操作（如发推、搜索），但绝对禁止在AI会话中执行任何涉及读取、输入密钥或令牌的认证步骤，所有认证必须由用户在终端手动完成。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/xurl/raw/index.md 读取 xurl 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/xurl/raw/index.md（查看排版版本）