API 文档

Base URL: https://getmoreneed.com · 认证: Authorization: Bearer mn_live_... · 请求体均为 JSON

最快接入:Agent 技能

set up https://getmoreneed.com/SKILL.md

流程

  1. discover — 找工具
  2. inspect — 看输入参数与价格
  3. run — 执行;返回 202 时轮询 /v1/runs/:runId

Endpoints

MethodPath说明
POST/v1/discover{"query":"twitter posts","limit":5} → {results, query, count} (免费)
POST/v1/inspect{"provider","endpoint"} → input schema + price (免费)
POST/v1/run{"provider","endpoint","input":{"queryParams"|"body"|"pathParams"}} → 200 / 202
GET/v1/runs?limit=&cursor=你的调用记录
GET/v1/runs/:runIdstatus: RUNNING / COMPLETED / FAILED, output, charge
GET/v1/wallet/balancebalance / held (MICRO_DOLLAR, 1 USD = 1,000,000)

示例

curl -X POST https://getmoreneed.com/v1/run \
  -H "Authorization: Bearer $MORENEED_API_KEY" -H "Content-Type: application/json" \
  -d '{"provider":"tikhub","endpoint":"/api/v1/twitter/web/fetch_tweet_detail","input":{"queryParams":{"tweet_id":"1808168603721650364"}}}'

计费

price 即你的单价。调用前按最高可能价格冻结(hold),完成后按实际扣费(charge)并退回差额。只有 status=COMPLETED 且 providerResponse.httpStatus < 400 才扣费。

归属标注

每个响应都带有 via: "moreneed"、poweredBy 字段和 X-Powered-By: moreneed 响应头。展示结果时请注明 “via moreneed”。

错误码

{"code","message"} — 400 参数错误 · 401 密钥无效 · 402 余额不足 · 404 不存在 · 429 请求过快 · 502 服务暂不可用(可重试)