账户总数
—销售终端 API 同步账户ACCOUNT OPERATIONS
让每个账户都处在
可用、可追踪的状态。
每个账户绑定独立 SOCKS5 出口,扫码、验证和采集均不暴露服务器公网 IP。
可用账户
—等待数据今日调用
—最近 24 小时使用商品数据
—由爬虫写入账户动态
最近添加或更新的账户
正在读取账户...
最近活动
账户与系统操作记录
正在读取活动...
| 账户 | 状态 | SOCKS5 代理 | 更新时间 | 操作 |
|---|---|---|---|---|
正在读取账户... | ||||
API GATEWAY
在线 API 服务
爬虫通过租约获取账户,写入商品数据;读取端使用独立只读密钥。
POST
/api/v1/accounts/lease领取账户租约
按最久未使用顺序选出已绑定 SOCKS5 的可用账户,返回租约、Cookie 和代理参数。
X-API-Key · 内部POST
/api/v1/accounts/:id/release归还并上报状态
爬虫完成调用后归还租约,可同步标记 Cookie 失效或新的过期时间。
X-API-Key · 内部GET
/api/v1/items查询采集数据
按关键词、价格区间和分页查询商品,数据模型可直接承接 goofish-client 搜索结果。
X-API-Key · 只读爬虫接入示例
租约、调用、归还的推荐顺序
const api = new URL('/api/v1/accounts/lease', BASE_URL);
const lease = await fetch(api, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': INTERNAL_API_KEY
},
body: JSON.stringify({
owner: 'crawler-01',
leaseSeconds: 300
})
}).then(r => r.json());
const proxyAgent = new SocksProxyAgent(lease.proxy.url);
const client = new Goofish({ cookie: lease.cookie });
for (const http of [
client.httpClientMtop,
client.httpClientPassport
]) {
const axios = http.getAxios();
axios.defaults.httpAgent = proxyAgent;
axios.defaults.httpsAgent = proxyAgent;
axios.defaults.proxy = false;
}
const result = await client.api.mtop.search.search({
keyword: 'MacBook Pro',
pageNumber: 1
});
接入信息
服务地址与密钥位置
API 基础地址
http://localhost:3000爬虫密钥
.data/internal-api-key只读密钥
.data/read-api-key健康检查
/api/health网络出口
账户级 SOCKS5 强制隔离API 密钥不会下发到控制台页面。部署时建议通过环境变量注入并使用 HTTPS。
AUDIT TRAIL
操作日志
记录 Cookie 更新、账户租约、验证结果和敏感信息查看。