MIYAIP API 参考

MIYAIP 开发者中心

将应用连接到代理、通过 API 管理代理资源，或使用托管的采集与浏览器服务。请从适合你的连接类型的指南开始。

选择接入方式查看代理 API 接口

当前应用契约 8 个已核对接口

基础地址https://miyaip.com

HTTPS

你要接入什么？

在应用中使用代理

将代理端点配置到 curl、Python、浏览器或其他支持代理的客户端。

所需凭据: 分配的代理主机、端口和鉴权字段

测试连接全部接入指南

代理账户与资产 API

完成鉴权、生成代理，并查询账户用量或代理资产。

所需凭据: 文档指定的登录流程返回的访问 Token

浏览接口

提交异步采集任务

选择支持的接口，提交参数，并通过任务 ID 获取结果。

所需凭据: Crawler API 文档指定的控制台登录 Token

Crawler API 文档

通过 MCP 使用 AI 浏览器

将兼容的 AI 客户端连接到 MIYAIP 浏览器工具。

所需凭据: 单独创建的 MCP 密钥

配置 Browser MCP

代理 API 参考

发送请求前，请先查看接口方法、输入字段和响应格式。点击运行后，在线调试工具会发送真实请求。

POST 无需鉴权

概览

构建请求

查看此接口的方法、参数和响应格式，并使用对应的代码示例构建请求。

AUTH

鉴权

无需鉴权

无需鉴权请求头，请填写有效的邮箱地址。

INPUT

参数

名称	位置	类型	说明
`email`必填	请求体	`string`	用于登录的邮箱地址。
`loginType`必填	请求体	`enum`	选择密码登录或验证码登录。
`passWord`敏感	请求体	`string`	loginType 为 pwd 时必填。
`verifyCode`敏感	请求体	`string`	loginType 为 code 时必填。

OUTPUT

响应示例

200登录成功application/json

{
  "code": 200,
  "message": "Success",
  "body": {
    "id": 1024,
    "name": "developer",
    "token": "<ACCESS_TOKEN>"
  }
}

400业务或参数错误application/json

{
  "code": 500,
  "message": "Invalid request",
  "body": null
}

SDK / HTTP

代码示例

从完整流程开始

验证静态代理

核对连接字段、发送请求，并对比实际出口 IP。

查看指南

使用 Python 采集数据

使用 Requests 或 Scrapy，处理响应、重试并保存输出。

查看指南

运行 Playwright 浏览器任务

配置代理，并在同一浏览器流程中检查会话。

查看指南

提交采集任务

查看接口目录、任务提交、结果获取和积分字段。

查看指南

配置与排查 HTTP 请求

常见问题

在 Python 中使用代理必须调用代理 API 吗？

不需要。如果已有连接字段，直接在 HTTP 客户端中配置代理即可。应用需要通过程序生成或管理代理资源时，再使用 API。

可以在 Crawler API 请求中使用 MCP 密钥吗？

不可以。请按 Crawler API 文档使用登录 Token。MCP 密钥用于独立的 Browser MCP 连接。

哪个 API 会返回任务 ID？

Crawler API 使用异步任务流程。请阅读文档中的任务提交、状态、结果和积分用量说明。

端点有效但 Chrome 无法连接时，应从哪里开始？

检查浏览器实际生效的代理设置，并从同一设备测试连接。按照连接错误指南区分浏览器配置问题与端点连通性问题。代理连接错误指南 →