官方文档
把 PageDrop 接进你的工作流
所有功能共享同一套 token、同一套限流、同一套错误码。下面四种方式按需选用,文档 + 交互式 playground 都在左侧 sidebar 里。
REST API
直接调用 /v1/* 接口
Bearer-token REST。上传 / 分享 / 校验 / 查询等能力共用一个接口体系,token 默认限流 5/min,可按 token 配置。
MCP
把 PageDrop 接进 AI 客户端
@pagedrop/mcp npm 包,stdio + streamable HTTP 双模式。6 个 tool 在 Claude Code / Cursor / Claude Desktop 直接可用。
Skill
一键给 Agent 学会分享
SKILL.md 教 Agent 何时调 MCP、怎么用合理默认(expire / password / oneTime)。复制粘贴即装。
CLI
终端 / CI 单文件分享
pagedrop upload ./report.md --share —— 上传 HTML / Markdown / TXT 并拿到 share URL。
最小 REST 例子
curl -H "Authorization: Bearer $TOKEN" \
-F "file=@notes.md;type=text/markdown" \
-F 'share={"expiresInDays":7}' \
http://117.72.193.223:10180/api/v1/files完整端点表 + 错误码表见 API 参考, OpenAPI 3.1 spec 见 /api/openapi.json。
给 AI / LLM 用:纯文本入口
每个 docs 页面都有 .txt 双胞胎, 内容是 markdown 源码,没有 HTML 外壳,方便复制给 ChatGPT / Claude / Cursor。
- /llms.txt — 整站文档目录(llms.txt 规范)
- /developers.txt — 本页(首页)的纯文本版
- /developers/getting-started.txt — 60 秒上手 + 选择集成方式(REST / MCP / Skill / CLI / Webhook)
- /developers/api.txt — /v1/* 端点完整参考 + 错误码 + curl 例子
- /developers/mcp.txt — @pagedrop/mcp stdio / streamable HTTP 双模式,6 个 tool
- /developers/skill.txt — @pagedrop/skill SKILL.md 模板 + 安装方法 + 示范脚本
- /developers/cli.txt — @pagedrop/cli 命令行客户端:login / upload / share / ls / rm
- /developers/webhooks.txt — share_visited / share_reported 事件 + HMAC-SHA256 签名 + 审计日志