快速开始

PageDrop 托管 HTML / Markdown / TXT 单文件，生成带有效期、密码、访问次数上限、 一次性、自定义短链或指定版本等策略的分享链接。控制台里能点出来的每一个操作，都同样 可以通过 REST API、MCP 服务（面向 AI 客户端）或官方 CLI 自动化完成。

60 秒上手

1. 创建账号：到 http://117.72.193.223:10180/signup（或你自己的部署地址）注册。
2. 上传第一份文件：进入 /files，拖拽一个 .html / .md / .txt 文件即可。
3. 拿到分享链接：在文件行点 "创建分享"，或在上传时同时附带一个 share 段，一次请求搞定。
4. （可选）创建 API token：去 /developers/tokens 生成，用于以编程方式驱动 PageDrop。

三种集成方式

方式	适用场景	文档
REST API	通用脚本、CI、服务端到服务端	API 参考
MCP 服务	Claude Code / Cursor / Claude Desktop 等任何支持 MCP 的 AI 客户端	MCP 接入指南
Skill	一行复制即可让 AI 助手学会调度 PageDrop 工具的"行为说明书"	Skill
CLI	在终端里直接 pagedrop upload ./report.md	CLI
Webhooks	访问 / 举报等事件发生时推送到你的服务器	Webhooks

一次完整的端到端示例（curl）

BASE=http://117.72.193.223:10180
TOKEN=pd_XXXXXXXX_YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY

# 1. 验证 token 可用
curl -s -H "Authorization: Bearer $TOKEN" $BASE/api/v1/me | jq

# 2. 上传文件并在同一次请求里创建 7 天分享
curl -s -H "Authorization: Bearer $TOKEN" \
  -F "file=@notes.md;type=text/markdown" \
  -F 'share={"expiresInDays":7}' \
  $BASE/api/v1/files

# 响应包含 { file: {...}, share: {...}, url: "<完整分享 URL>" }

交互式 Playground

如果你更习惯点击而不是 curl，可以打开 Playground： 粘上你的 token（或直接复用当前已登录的 session），就能在浏览器里把每个接口试一遍。

把整站文档喂给 AI

/developers/* 下的每一页都有对应的 .txt 双胞胎，返回去除 HTML 外壳的原始 markdown， 方便你贴给 ChatGPT / Claude / Cursor 等 AI：

• 总目录：/llms.txt
• 单页：/developers/api.txt（任何 slug 都行）