| name | medium-push |
| category | publishing |
| description | 将 Markdown 文件推送到浏览器中打开的 Medium 编辑器。当用户说"发布到 medium"、"推送到 medium"、"paste to medium"、"push to medium"或在完成文章生成后要求发送到 Medium 时触发。 |
medium-push - 推送 Markdown 到 Medium 编辑器
通过 Chrome 扩展 + Bridge 服务（HTTP + SSE），将本地 Markdown 文件转换为富文本并推送到浏览器中打开的 Medium 编辑器。
架构
Claude Code (读取 Markdown 文件)
→ curl POST http://localhost:18766/paste
→ Bridge Server (SSE 推送)
→ Chrome Extension (content script)
→ Markdown → HTML 转换
→ Medium 编辑器 (模拟粘贴富文本)
工作流程
步骤 1：检查 Bridge 服务
curl -s http://localhost:18766/health 2>/dev/null || echo "NOT_RUNNING"
| 结果 | 操作 |
|---|
{"status":"ok",...} | Bridge 已运行，跳到步骤 2 |
NOT_RUNNING | 启动 Bridge 服务 |
启动 Bridge：
nohup node <skill-path>/scripts/bridge.mjs > /tmp/medium-push-bridge.log 2>&1 &
echo $!
等待 1 秒后再次检查 /health 确认启动成功。
步骤 2：确认 Medium 编辑器已打开
提示用户在 Chrome 中打开 Medium 新文章页面：
https://medium.com/new-story
步骤 3：读取 Markdown 文件
读取用户指定的 Markdown 文件路径。如果用户没有指定，查找 blog-external/ 目录下的 medium.md 文件。
步骤 4：发送到 Medium 编辑器
方式 A：通过文件路径（推荐）
curl -s -X POST http://localhost:18766/paste \
-H "Content-Type: application/json" \
-d '{"filePath": "<absolute-path-to-markdown-file>"}'
方式 B：直接发送内容
curl -s -X POST http://localhost:18766/paste \
-H "Content-Type: application/json" \
-d @- <<'PAYLOAD'
{"content": "<markdown-content-here>"}
PAYLOAD
步骤 5：确认结果
检查响应中的字段：
| 字段 | 含义 |
|---|
success: true | 请求成功 |
clientsSent > 0 | 内容已推送到浏览器扩展 |
clientsSent = 0 | 没有连接的扩展客户端 |
如果 clientsSent = 0，提示用户：
- 确认 Chrome 扩展已安装
- 确认已打开
https://medium.com/new-story 页面
- 刷新页面后重试
输出格式：
文章已推送到 Medium 编辑器！
文件：{file_path}
内容长度：{contentLength} 字符
浏览器客户端：{clientsSent} 个
请在浏览器中查看 Medium 编辑器并检查内容格式。
首次安装
1. 安装 Chrome 扩展
- 打开 Chrome，访问
chrome://extensions/
- 开启右上角 开发者模式
- 点击 加载已解压的扩展程序
- 选择
<skill-path>/extension/ 目录
- 安装完成
2. Bridge 服务
Bridge 为纯 Node.js 实现，零外部依赖，无需 npm install。
默认端口 18766（避免与 md-push 的 18765 冲突），可通过 BRIDGE_PORT 环境变量修改。
注意事项
- Bridge 使用 SSE（Server-Sent Events）推送，扩展会自动重连
- 扩展会自动剥离 Markdown 的 YAML frontmatter
- Markdown 在扩展端转换为 HTML 后通过模拟粘贴注入 Medium 编辑器
- 第一个
# 标题会自动填入 Medium 的标题字段
- 支持：标题、段落、粗体、斜体、代码块、行内代码、链接、图片、列表、引用
- 扩展 popup 支持手动粘贴（无需 Bridge）
