Apifox Exporter

Apifox Exporter Skill

版本： 2.0.0 作者： 果果 @ 婉秋 描述： 全自动从 Apifox 导出接口数据并整理成标准格式的文档

---

✨ v2.0.0 新特性

现在支持全自动浏览器自动化！

✅ 全自动模式：一键完成所有操作（登录→选择团队→选择项目→导出→整理）

✅ 登录状态保存：首次登录后，后续无需重复登录

✅ 多团队支持：自动查找项目所在团队

✅ 灵活的口令：支持多种指定团队和项目的方式

✅ 半自动模式：保留原有手动导出方式作为备用

---

🚀 使用方式

方式 1：全自动模式（推荐）

基础口令：

更新接口文档
导出接口
刷新 Apifox 接口

指定项目（团队用默认）：

更新接口文档，用商城项目
更新接口文档 - 商城

指定团队和项目：

更新接口文档，团队是xxxx，项目是xxx
更新接口文档 - 团队名 - 项目名

方式 2：半自动模式（备用）

半自动更新接口文档

需要手动从apifox点击导出按钮导出借楼json文件后存到 ~/.openclaw/workspace/script/apifox/source.json，其他自动完成。

---

📋 配置默认值

修改 script/auto-export-playwright.js 开头的默认配置：

const DEFAULT_TEAM_NAME = '团队名';
const DEFAULT_PROJECT_NAME = '项目名';

---

📁 文件结构

apifox-exporter/
├── SKILL.md                    # Skill 描述
├── README.md                   # 详细文档
├── skill.yaml                  # Skill 配置
├── package.json                # 依赖配置
├── script/
│   ├── auto-export-playwright.js  # 全自动脚本（主入口）
│   ├── auto-export.js             # 半自动脚本（备用）
│   └── export.js                  # 核心处理脚本
└── .gitignore

运行时生成：

chrome-profile/ - 浏览器登录状态（首次运行后登录创建，一次登录后面就自动保存登录状态）

source.json - 下载的原始数据

Apifox 接口导出.txt - 最终输出（桌面）

---

🔧 安装方法

方法 1：从 ClawHub 安装

openclaw skill install apifox-exporter

方法 2：手动安装

1. 复制 skill 文件夹到 ~/.openclaw/workspace/skills/apifox-exporter/ 2. 安装依赖：

cd ~/.openclaw/workspace/skills/apifox-exporter
npm install
npx playwright install chromium

---

💡 首次使用

1. 运行口令：说"更新接口文档" 2. 扫码登录：浏览器会自动打开，扫码登录 Apifox 3. 自动保存：登录状态会保存，下次无需重新登录 4. 自动导出：脚本会自动完成后续所有操作

---

🎯 输出位置

| 文件 | 位置 | |------|------| | 接口文档 | 桌面\Apifox 接口导出.txt | | 原始数据 | ~/.openclaw/workspace/script/apifox/source.json |

---

⚠️ 注意事项

1. 首次使用需要登录：登录状态会保存，后续无需重复登录 2. 保持网络畅通：需要访问 Apifox 云端 3. 下载目录可访问：下载的文件会保存到脚本目录 4. 敏感数据安全：导出的文档包含示例数据，注意不要包含真实密码

---

🐛 常见问题

Q: 登录状态失效了怎么办？

A: 重新运行脚本，会提示你重新登录，登录后会自动保存新状态。

Q: 找不到项目怎么办？

A: 脚本会自动尝试所有团队，如果还是找不到，可以手动在浏览器中进入项目。

Q: 下载的文件没找到？

A: 检查下载事件监听是否正常，或查看 Chrome 默认下载路径。

Q: 想用回手动导出？

A: 说"半自动更新接口文档"即可。

---

📝 更新日志

v2.0.0 (2026-03-19)

✨ 新增 Playwright 全自动浏览器自动化

✨ 支持多团队自动查找

✨ 登录状态持久化保存

✨ 灵活的命令行参数支持

✨ 多种自然语言口令格式

v1.0.1 (2026-03-18)

🔧 修复硬编码路径问题

📝 明确说明需要手动导出

v1.0.0 (2026-03-18)

✨ 初始版本发布

---

Made with ❤️ by 果果