Cross Request Master
面向 API 开发/测试的 Chrome 扩展：绕过 CORS 发请求、自动生成 cURL，并对 YApi「运行」页做增强（内嵌 cURL、路径参数 {param} 引导填写）。
本仓库包含生态内的多个子项目：
packages/yapi-mcp — CLI / Skill（发布包名保持为 @leeguoo/yapi-mcp，MCP 配置作为兼容方案保留，不影响扩展打包）plugins/yapi-plugin — Cursor 与 Claude Code 插件（已从原独立仓库 leeguooooo/yapi-plugin 归档并整合回本仓库）
当前推荐安装链路是 npx skills add leeguooooo/cross-request-master -y -g 安装 Skill，再用 yapi config init 初始化 ~/.yapi/config.toml。yapi-mcp 已支持浏览器登录同步 Cookie（yapi login --browser），可用于仅支持 SSO/无法账号密码登录的 YApi 场景。
功能特性
- 跨域请求（CORS bypass）：在页面侧调用
crossRequest，由扩展后台代发
- 内嵌 cURL：YApi「运行」页 URL 下方展示可复制的 cURL 命令
- 路径参数引导：URL 含
{param} 时提示填写，避免请求失败
- 固定 Header：为跨域请求自动追加自定义 Header
- YApi 工具箱：Skill 一键安装（推荐，支持
npx skills add）/ Cursor 与 Claude Code 插件（plugins/yapi-plugin/）/ MCP 配置（兼容）/ CLI 使用与 docs-sync
- 复制给 AI：把当前接口信息整理为 Markdown 一键复制
- 现代请求支持：优先
fetch / Promise 工作流，兼容历史 $.ajax
- Manifest V3：兼容最新 Chrome 扩展标准
安装
Chrome Web Store（推荐）
https://chrome.google.com/webstore/detail/efgjanhcajpiljllnehiinpmicghbgfm
开发者模式
git clone https://github.com/leeguooooo/cross-request-master.git
cd cross-request-master
./build-extension.sh
然后在 chrome://extensions/ 开启开发者模式 → “加载已解压的扩展程序” → 选择 build/。
使用
在 YApi 中
安装后直接在 YApi「运行」页发送请求即可，扩展会自动处理跨域、显示 cURL，并把 JSON 响应解析为对象供脚本使用。
在接口详情页（基本信息区域右上角）额外提供：
- YApi 工具箱：包含 Skill 一键安装（推荐，支持 Codex/Claude/Cursor 与
npx skills add）、MCP 配置（兼容）、CLI 使用与 docs-sync 说明（自动拼好命令）
- 复制给 AI：把当前接口信息整理成 Markdown（仅接口相关字段）复制到剪贴板
如果你要在本机直接装好 Skill + CLI，当前最短路径是：
npm install -g @leeguoo/yapi-mcp
npx skills add leeguooooo/cross-request-master -y -g
yapi config init --base-url=https://your-yapi-domain.com --auth-mode=global [email protected]
yapi login --base-url=https://your-yapi-domain.com --browser
更完整说明见 packages/yapi-mcp/README.md。
ClawHub Skill 同步
pnpm run clawhub:sync:dry
pnpm run clawhub:sync
YApi OpenAPI（Yapi-MCP tool 同名方法）
扩展在页面侧额外暴露 window.crossRequest.yapiMcp（也可用 window.crossRequest.yapi），把 YApi OpenAPI 封装成与 Yapi-MCP 一致的 5 个方法，方便直接在浏览器控制台/脚本里操作接口文档：
// 先配置（支持多项目：'28:token1,29:token2'）
window.crossRequest.yapiMcp.configure({
baseUrl: 'https://your-yapi-domain.com',
token: '28:your_project_token'
});
// 查接口、拉分类、搜索、保存
const api = await window.crossRequest.yapiMcp.yapi_get_api_desc({ projectId: '28', apiId: '66' });
在任意网页中手动调用
window.crossRequest({
url: 'https://api.example.com/data',
method: 'GET',
headers: { Authorization: 'Bearer token' },
success(res) {
console.log('Success:', res);
},
error(err) {
console.error('Error:', err);
}
});
crossRequest 也会返回 Promise：
const resp = await window.crossRequest({ url: '/api/ping' });
console.log(resp.status, resp.data);
兼容模式：jQuery（Legacy）
大多数场景建议直接使用 fetch + window.crossRequest。以下仅用于历史页面仍依赖 $.ajax 时：
- YApi/目标站点：默认拦截所有
$.ajax。如需关闭：crossRequest: false
- 其他站点：默认不拦截。需显式开启：
crossRequest: true
$.ajax({
url: 'https://api.example.com/data',
method: 'GET',
crossRequest: true
});
文件上传（FormData）
const fd = new FormData();
fd.append('file', fileInput.files[0]);
fd.append('name', 'demo');
await window.crossRequest({
url: 'https://api.example.com/upload',
method: 'POST',
body: fd
});
TypeScript 类型定义
仓库内置 types/cross-request.d.ts，可直接复制到你的项目并在 tsconfig.json 中 include，或在 global.d.ts 引用：
/// <reference path="./types/cross-request.d.ts" />
已知限制 / FAQ
- 自定义 Header 被放到
Access-Control-Request-Headers：这是浏览器 CORS 预检行为，需要服务端正确返回 Access-Control-Allow-Headers。
- Network 面板看不到请求：请求由扩展后台发出，不会出现在页面 Network；可在扩展 Service Worker 的 Network/Console 查看。
开发与测试（本仓库）
