SuperAPI AI 工具集

poshmark

通用与其它

查看项目

更新于 10-22 01:53

技能介绍

用途

Unbrowse for Poshmark 将 poshmark.com 的能力封装为可供 AI 智能体调用的工具。它是非官方实现,与 poshmark.com 无关联、也未获其认可。Unbrowse 根据 poshmark.com 自身的请求编译这些工具:每次调用在服务端重放该站点的第一方 API,并返回经过验证的结果。这种方式不抓取渲染后的页面,用户侧无需运行浏览器,也不需要 poshmark.com 的 API 密钥。

主要能力

该服务器是一个工具作用域,仅包含 poshmark.com:其编译出的工具,以及运行这些工具的 Unbrowse 工具,因此智能体的工具列表保持精简,且每次调用都限定在 poshmark.com 上。

核心工具:

  • poshmark_com__get_search — 按关键词搜索市场商品列表。
    • 输入:second_search_query(字符串,必填)——第二个搜索查询(在“fill Search”期间输入)。
    • 站点自身参数(均可选,省略时发送记录值):type(字符串,记录值为 "listings")。
    • select(数组)——仅保留结果中的指定部分:点号遍历键,[] 映射列表,末尾 {a,b} 保留多个键(例如 "results[].{title,url}")。未匹配的路径会在 selectMissing 中返回。
    • 返回该页面的标题、可读文本和链接。对 poshmark.com 为只读操作。

此外始终可用的工具包括:unbrowse_run(用自然语言在 poshmark.com 上执行任务)、unbrowse_inspect、unbrowse_resume、unbrowse_scrape 和 unbrowse_map(poshmark.com 上的任意页面),以及已记录的云端浏览器工具 unbrowse_browse_open → unbrowse_browse_act → unbrowse_browse_finish。拒绝点号名称的主机会以 _ 形式显示它们(如 unbrowse_run)。

使用方式

连接 poshmark.com MCP

Claude:

claude mcp add --transport http poshmark https://unbrowse.ai/mcp/poshmark.com

Codex:

codex mcp add poshmark --url https://unbrowse.ai/mcp/poshmark.com && codex mcp login poshmark

JSON 配置:

{"mcpServers":{"poshmark":{"url":"https://unbrowse.ai/mcp/poshmark.com"}}}

首次连接会通过 OAuth 登录 Unbrowse(免费层,仅验证结果计数)。对于脚本,发送 Authorization: Bearer $UNBROWSE_API_KEY(密钥来自 https://unbrowse.ai/app/keys;请保存在密钥管理器中,切勿写入会提交的配置)。

如果当前会话的工具列表中不包含上述工具,说明服务器未连接或未登录:应说明情况并停止。不要以其他方式获取 poshmark.com 并将其作为此技能的结果呈现。

如何调用

选择标题与任务匹配的工具并传入其输入。除非用户要求控制站点自身参数,否则不要传入这些记录参数。

读取状态:succeeded 携带经过验证的结果。input_required 不是失败:用 unbrowse_resume {runId, answers} 在同一运行中回答未填字段。

没有合适工具时:使用 unbrowse_run {task}。当尚无编译好的能力时,它会以 no_capability 失败:此时用 unbrowse_browse_open 在 poshmark.com 上执行一次 → unbrowse_browse_act → unbrowse_browse_finish,这会编译出一个新工具,供此服务器下次列出。任何 poshmark.com 之外的操作在此都会被拒绝(not_in_scope):请改用通用 Unbrowse 服务器。

登录:切勿向用户索要密码。使用 unbrowse_browse_act 并设置 action: "autofill",从其 Unbrowse 密码管理器填充 poshmark.com 的登录信息。

仅报告 succeeded 结果所述内容。outcome_unknown 表示可能已发生更改:重试前请先检查。发布、购买、发送或删除操作需要用户同意。

不使用 MCP

每个工具同时也是 REST 调用:

curl -s https://unbrowse.ai/api/v1/sites/poshmark.com/call/poshmark_com__get_search \
  -H "authorization: Bearer $UNBROWSE_API_KEY" -H "content-type: application/json" \
  -d '{"second_search_query":"<second_search_query>"}'

OpenAPI:https://unbrowse.ai/api/v1/sites/poshmark.com/openapi.json。其他所有站点:请使用通用 Unbrowse 技能(https://github.com/unbrowse-ai/unbrowse)和 https://unbrowse.ai/mcp。

适用场景

适用于需要让 AI 智能体按关键词搜索 Poshmark 市场商品列表的场景,例如在智能体工作流中检索商品信息、标题、文本和链接。由于对 poshmark.com 为只读操作,适合信息查询类任务。

限制

  • 非官方实现,与 poshmark.com 无关联、未获其认可。
  • 仅限 poshmark.com 范围内的操作;范围外的请求会被拒绝(not_in_scope)。
  • 首次连接需通过 OAuth 登录 Unbrowse;脚本调用需 API 密钥。
  • 发布、购买、发送或删除等操作需要用户同意。
  • 关于收费、价格、平台支持范围等更多细节,资料中暂未提供。