mirror of https://github.com/7836246/cursor2api.git synced 2026-05-07 22:27:15 +08:00

Files

- 重构为标准 Go 项目结构 (cmd/server, internal/)
- 配置改为 YAML 格式
- 添加 Anthropic Messages API 支持
- 添加 OpenAI Chat API 支持
- 浏览器自动化处理人机验证
- 添加详细中文注释
- 添加免责声明

2025-12-16 19:50:35 +08:00

3.2 KiB

Raw Blame History

Cursor2API

将 Cursor API 转换为 OpenAI/Anthropic 兼容格式的代理服务。

原理

本项目利用 Cursor 文档页面提供的免费 AI 聊天功能。该页面内置了一个 AI 助手，通过 https://cursor.com/api/chat 接口与后端通信。

关键特点：

无需登录 - 文档页面的 AI 聊天功能对所有访问者开放
无需 API Key - 不需要 Cursor 账号或付费订阅
支持多模型 - 可使用 Claude、GPT、Gemini 等模型

本项目通过浏览器自动化技术访问该页面，将请求转发到 Cursor API，并将响应转换为标准的 OpenAI/Anthropic API 格式。

功能特性

Anthropic Messages API - 完整支持 /v1/messages 接口
OpenAI Chat API - 支持 /v1/chat/completions 接口
流式响应 - 支持 SSE 流式输出
浏览器自动化 - 自动处理人机验证

项目结构

cursor2api/
├── cmd/server/          # 程序入口
│   └── main.go
├── internal/            # 内部包
│   ├── browser/         # 浏览器自动化服务
│   ├── config/          # 配置管理
│   └── handler/         # HTTP 处理器
├── static/              # 静态文件
├── config.yaml          # 配置文件
└── README.md

快速开始

# 安装依赖
go mod tidy

# 编译
go build -o cursor2api ./cmd/server

# 运行
./cursor2api

服务默认运行在 http://localhost:3010

配置

编辑 config.yaml：

# 服务端口
port: 3010

# 浏览器设置
browser:
  headless: true
  path: "/usr/bin/chromium"

支持环境变量 PORT 覆盖端口配置。

API 接口

Anthropic Messages API

curl http://localhost:3010/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: any" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}],
    "stream": true
  }'

OpenAI Chat API

curl http://localhost:3010/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4",
    "messages": [{"role": "user", "content": "Hello"}],
    "stream": true
  }'

其他接口

GET /v1/models - 获取模型列表
GET /health - 健康检查
GET /browser/status - 浏览器状态

Claude Code 集成

# 设置 API 地址
export ANTHROPIC_BASE_URL=http://localhost:3010

# 运行 Claude Code
claude

支持的模型

请求模型	映射到 Cursor
claude-*	anthropic/claude-sonnet-4.5
gpt-*	openai/gpt-5-nano
gemini-*	google/gemini-2.5-flash

依赖

Go 1.21+
Chromium 浏览器

免责声明

本项目仅供学习和研究目的使用。

本项目是一个非官方的第三方工具，与 Cursor 官方无任何关联
使用本项目可能违反 Cursor 的服务条款，请自行承担风险
本项目不提供任何形式的担保，包括但不限于适销性、特定用途适用性
作者不对使用本项目造成的任何直接或间接损失负责
请勿将本项目用于商业用途或任何违法活动

使用本项目即表示您已阅读并同意以上声明。

许可证

MIT

3.2 KiB Raw Blame History Unescape Escape