SuperAPI AI 工具集

clawdirect-dev

前端与建站

查看项目

更新于 10-16 09:33

技能介绍

用途:构建面向 AI 智能体的 Web 体验,采用 ATXP(Agent Transaction Protocol)实现智能体身份识别与付费,参考实现为 napoleond/clawdirect。

主要能力:ATXP 提供智能体身份、可选付费(Premium 操作计费)和 MCP 集成(暴露可编程工具)。智能体通过两种方式交互:浏览器自动化(点击、填表、导航)与 MCP 工具直接调用。cookie 认证模式将两者桥接:智能体经 MCP 取得认证 cookie,再在浏览时使用。因智能体浏览器常无法直接设置 HTTP-only cookie,推荐做法是智能体在查询串传递 cookie 值(如 ?myapp_cookie=XYZ),由服务端设置 cookie 并重定向到干净 URL。

使用方式:初始化 Node 项目并安装依赖:npm install @longrun/turtle @atxp/server @atxp/express better-sqlite3 express cors dotenv zod;开发依赖 typescript @types/node @types/express @types/cors @types/better-sqlite3 tsx。配置 .env 的 FUNDING_DESTINATION_ATXP 与 PORT。用 SQLite 存 auth_cookies(cookie_value 主键、atxp_account、created_at),提供 createAuthCookie 与 getAtxpAccountFromCookie。用 defineTool 在 MCP 中定义 cookie 工具(免费但需 ATXP 认证)与付费工具(如 requirePayment 收费 0.10)。Express 侧用 requireCookieAuth 中间件校验 cookie。服务入口用 createServer 创建 MCP,atxpExpress 挂载 /mcp,并提供 ?myapp_cookie= 引导中间件设置 HTTP-only cookie 后 302 重定向。最后编写 SKILL.md 供智能体使用:npx skills add atxp-dev/cli --skill atxp;npx atxp-call https://your-domain.com/mcp <tool> [params]。

适用场景:需要让智能体以身份访问、执行受保护操作或付费调用的网站。

限制:需 Node.js 18+ 与 SQLite 持久存储(或改用 PostgreSQL);浏览器 cookie 直接设置不可靠,须走查询串方案;文档未提供具体价格细节,除示例中的 $0.10 与 ClawDirect 目录费用(新增 $0.50、编辑 $0.10、删除免费)外,其余收费信息暂未提供。