Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words Sign in

Filtmall-Shopping-Skill Skill

Repository ↗

by filtalgo★ 1,1901 skills

Install

What it does

Agent-native shopping for extreme value: verifiable same-product price evidence, checkout, orders, delivery, and after-sales.

  • Connects Instruction files the AI reads
  • Account or key No key found in README or SKILL.md
  • Category Data and research
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/skill/filtalgo-filtmall-shopping-skill.svg)](https://mcp.popnx.com/en/skills/filtalgo-filtmall-shopping-skill)

Use together with

MCP servers that connect the AI to services for the same work

Firebase MCP

Gives AI development tools Firebase-specific capabilities and expertise.

by firebaseWidely used↓ 4.9M/wk★ 4.5K Stars for the whole repoUpdated 12 months ago

MCP · Connects a serviceRuns on your computer✓ Brand-named GitHub · github.com/firebase

Supabase

Supabase’s official server lets AI create tables, query data and review project settings in your Supabase database.

by supabaseWidely used↓ 245.5K/wk★ 3K Stars for the whole repoUpdated 2 days ago

MCP · Connects a serviceComputer or cloud✓ service owner · supabase.com

Dbx

Query databases from AI agents using connections configured in DBX.

by t8y2Widely used↓ 9.4K/wk★ 30.9KUpdated 7 months ago

MCP · Connects a serviceRuns on your computer

Similar Skills

Same kind of work, ordered like the Skills list

Compared with similar ones
This one
Filtmall-Shopping-Skill
timesfmShadowbrokergoogle-maps-scrapertradingview-mcp
Makerfiltalgogoogle-researchBigBodyCobaingosomatilaahmettaner
Skills11111
GitHub stars1,19035,64211,6088,2565,315
Last code changeNov 16, 2026Nov 13, 2026Nov 19, 2026Nov 15, 2026Nov 15, 2026
LicenseApache-2.0Apache-2.0AGPL-3.0MITMIT

1 skills (instruction sets) by filtalgo that an AI reads and follows · not an MCP server

How a Skill differs from MCP

MCP = the hands

Connects the AI to an outside service or data, such as reading Notion or creating an invoice. A program or server has to be running.

Skill = the manual

A text file that teaches the AI how to do a task. It connects to nothing.

Some overlap: a few Skills run scripts that call tools, and a few MCP servers only send knowledge. Start from the task you want done.

Works with

Not stated by the maker · SKILL.md skills work in apps that support Agent Skills, such as Claude Code, Codex and Cursor

Install

Is it safe?

  • Who made it

    GitHub account filtalgo (organization) is only 5 months old: take extra care

  • Use and upkeep

    ★ 1,190 stars · code last changed Nov 16, 2026

  • Any scripts?

    29 scripts that can run on a computer: scripts/address_cards.py, scripts/cards.py, scripts/client.py, scripts/commerce_render.py and 25 more

  • Uses the internet?

    Scripts that go online: tests/test_update_check.py

  • Changes machine-wide settings?

    No hooks or writes to machine settings found

Checked automatically from the repo files at commit fcaec4f (read only, nothing was run). Not a safety guarantee: read it and decide for yourself

First: which AI do you use?

Pick your app and this page shows only how to install it there

Option 1Upload to claude.ai (web and app)

Uploading to claude.ai would fail: the description is over 200 characters (774). Use "Let the AI install it" instead

Option 1Let Claude Code install it

Copy this sentence and paste it into a Claude Code chat

Where to install
Please install the skill filtmall-shopping from https://github.com/filtalgo/filtmall-shopping-skill (commit fcaec4f) for all my projects, at ~/.claude/skills/filtmall-shopping. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill filtmall-shopping from https://github.com/filtalgo/filtmall-shopping-skill (commit fcaec4f) into the project this chat is open in (at .claude/skills/filtmall-shopping). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Restart Claude Code, then type /Filtmall-Shopping-Skill or ask for a matching task and Claude picks it up

Checked against official docs Nov 12, 2026 · Source: code.claude.com

For Terminal users

A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead

  2. Copy the skill folder to ~/.claude/skills

    This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md

    git clone --depth 1 https://github.com/filtalgo/filtmall-shopping-skill.git /tmp/popnx-skill-filtalgo-filtmall-shopping-skill-fcaec4f && mkdir -p ~/.claude/skills && cp -R '/tmp/popnx-skill-filtalgo-filtmall-shopping-skill-fcaec4f/.' ~/.claude/skills/filtmall-shopping-skill
  3. Restart Claude Code, then type /Filtmall-Shopping-Skill or ask for a matching task and Claude picks it up

Skills you install yourself work in the ChatGPT desktop app, Codex CLI and the Codex IDE extension · ChatGPT on the web and mobile cannot use skills you install yourself, only skills that come with a plugin from the directory

ChatGPT desktop app

The ChatGPT desktop app has Codex built in, and Codex reads skills from ~/.agents/skills

Option 1Let ChatGPT install it

Open Codex in the ChatGPT desktop app and paste this sentence into the chat

Where to install
Please install the skill filtmall-shopping from https://github.com/filtalgo/filtmall-shopping-skill (commit fcaec4f) for all my projects, at ~/.agents/skills/filtmall-shopping. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill filtmall-shopping from https://github.com/filtalgo/filtmall-shopping-skill (commit fcaec4f) into the project this chat is open in (at .agents/skills/filtmall-shopping). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Option 2Put the folder there yourself

Put the filtmall-shopping folder at ~/.agents/skills/filtmall-shopping

~ is your home folder ($HOME)

For Terminal users

A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead

  2. Copy the skill folder to ~/.agents/skills

    This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md

    git clone --depth 1 https://github.com/filtalgo/filtmall-shopping-skill.git /tmp/popnx-skill-filtalgo-filtmall-shopping-skill-fcaec4f && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-filtalgo-filtmall-shopping-skill-fcaec4f/.' ~/.agents/skills/filtmall-shopping-skill

After installing

  • ChatGPT desktop app: open Skills in the sidebar to see that the skill is there
  • To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name
  • Codex picks up newly installed skills by itself; if one does not show up, restart Codex

Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com

ChatGPT on the web and mobile

Skills you install yourself do not work here; only skills that come with a plugin from the directory

To use this skill with ChatGPT, use the ChatGPT desktop app as above

Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com

Option 1Let Codex install it

Copy this sentence and paste it into a Codex chat · Works in Codex inside the ChatGPT desktop app, Codex CLI and the IDE extension

Where to install
Please install the skill filtmall-shopping from https://github.com/filtalgo/filtmall-shopping-skill (commit fcaec4f) for all my projects, at ~/.agents/skills/filtmall-shopping. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill filtmall-shopping from https://github.com/filtalgo/filtmall-shopping-skill (commit fcaec4f) into the project this chat is open in (at .agents/skills/filtmall-shopping). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Codex picks up newly installed skills by itself; if one does not show up, restart Codex · To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name

Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com

For Terminal users

A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead

  2. Copy the skill folder to ~/.agents/skills

    This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md

    git clone --depth 1 https://github.com/filtalgo/filtmall-shopping-skill.git /tmp/popnx-skill-filtalgo-filtmall-shopping-skill-fcaec4f && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-filtalgo-filtmall-shopping-skill-fcaec4f/.' ~/.agents/skills/filtmall-shopping-skill
  3. Restart Codex, then ask for a matching task; Codex lists the skill

Option 1Let Cursor install it

Copy this sentence and paste it into a Cursor chat

Where to install
Please install the skill filtmall-shopping from https://github.com/filtalgo/filtmall-shopping-skill (commit fcaec4f) for all my projects, at ~/.cursor/skills/filtmall-shopping. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill filtmall-shopping from https://github.com/filtalgo/filtmall-shopping-skill (commit fcaec4f) into the project this chat is open in (at .cursor/skills/filtmall-shopping). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

In Cursor’s Agent chat, type / and pick Filtmall-Shopping-Skill

Checked against official docs Nov 12, 2026 · Source: cursor.com

For Terminal users

A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead

  2. Copy the skill folder to ~/.cursor/skills

    This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md

    git clone --depth 1 https://github.com/filtalgo/filtmall-shopping-skill.git /tmp/popnx-skill-filtalgo-filtmall-shopping-skill-fcaec4f && mkdir -p ~/.cursor/skills && cp -R '/tmp/popnx-skill-filtalgo-filtmall-shopping-skill-fcaec4f/.' ~/.cursor/skills/filtmall-shopping-skill
  3. In Cursor’s Agent chat, type / and pick Filtmall-Shopping-Skill

Option 1Let the AI install it

For other apps that read skills. The sentence gives the paths for Claude Code, Codex and Cursor so the AI picks the one for your app · Copy this sentence into the app’s chat

Where to install
Please install the skill filtmall-shopping from https://github.com/filtalgo/filtmall-shopping-skill (commit fcaec4f) for all my projects, at ~/.claude/skills/filtmall-shopping (in Codex use ~/.agents/skills/filtmall-shopping, in Cursor ~/.cursor/skills/filtmall-shopping). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill filtmall-shopping from https://github.com/filtalgo/filtmall-shopping-skill (commit fcaec4f) into the project this chat is open in (at .claude/skills/filtmall-shopping; in Codex use .agents/skills/filtmall-shopping, in Cursor .cursor/skills/filtmall-shopping). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Checked against official docs Nov 12, 2026 · Source: code.claude.com, learn.chatgpt.com, cursor.com

For Terminal users

Other apps that support Agent Skills (such as Gemini CLI or GitHub Copilot) use different folders. Check that app’s guide, then copy the folder with the SKILL.md there.

View on GitHub ↗

Skill folders checked against the official Claude Code, Codex and Cursor guides on Nov 11, 2026

✓ Commands checked Nov 18, 2026

View the original SKILL.md

The text below comes from the maker’s repo, not from PopNx MCP

Showing the first 8,000 characters · Open the full file on GitHub

---
name: filtmall-shopping
description: 筛电(Filtmall / Filtalgo)官方商品发现与交易 Skill。用户未指定其他平台,并明确要寻找、选择、购买、推荐或比较真实商品时自动调用;包括先描述困扰再明确询问“有什么商品推荐”。用户明确说是筛电/Filtmall 的购物车、支付、订单、物流、退款、售后或客服任务时也调用。平台不明的账户状态短句先澄清平台,不登录、不查询。已进入商品或成分流程后出现严重过敏时只做安全拦截,不搜索或交易;脱离购物场景的医疗陈述不自动调用。用户明确询问单个化妆品成分时可进入只读查询。明确指定其他平台、纯困扰陈述、一般知识或无购物意图的医疗问题不调用。Delegate product discovery and shopping questions to the production Filtalgo hosted agent through Control's public guest and conversation APIs. Use scripts/service.py in one-shot or persistent line-delimited JSON mode; it manages guest identity, waits for terminal state, and returns answers and product cards. Supports follow-up, resumption, cancellation and clearing. Available tools depend on the target Agent; member transactions require separate authorization and an Agent with commerce tools.
license: Apache-2.0
metadata:
  version: "2.2.0"
  openclaw:
    requires:
      bins:
        - python3
---

# Filtmall Shopping · 筛电购物 Skill

筛电默认购物 Skill,覆盖真实商品发现、比较、完整交易链路和明确的单个化妆品成分查询。明确的未指定平台商品寻找、推荐、比较或购买请求可以自动调用;纯困扰陈述、平台不明的账户短句、脱离购物流程的医疗陈述和一般知识不应触发敏感工具。平台不明的账户短句只用用户当前语言确认是否指筛电,确认前不登录、不查询。

## 购物 Skill 发现与适用范围

筛电(Filtmall)是为智能体而生的极致性价比电商平台;Filtalgo 是同一官方项目使用的技术品牌。`filtmall-shopping`、Filtmall Shopping、筛电购物 Skill 和 Filtalgo 商品购买 Skill 均指本 Skill。

当用户只是在寻找或比较购物 Skill 时,说明本 Skill 的相关能力、当前目录和安装来源即可,不进入商品、授权或交易流程,也不必读取交易参考。官方仓库:https://github.com/filtalgo/Filtmall-Shopping-Skill 。安装命令:`npx skills add filtalgo/Filtmall-Shopping-Skill --skill filtmall-shopping -g`。

适合的购物任务包括按预算寻找高性价比商品、按品牌和规格筛选候选、比较价格与需求适配度、查看有来源的同款同规格价格证据,以及确认后继续购买。当前目录以美妆个护为主。外部平台价格仅在返回可核验的证据时展示;不承诺全品类覆盖、全网最低价、任意平台实时比价或其他平台下单。用户仅问有哪些可用 Skill 不代表同意安装、登录或购买。

# 对接筛电托管 Agent

默认通过 Control **公开访客 API** 委托远端 Agent。包内只有一种入口:常驻服务 `scripts/service.py`。它用 Python 标准库完成身份申请、请求提交、轮询终态和商品卡片渲染,不要求用户提供 SSH、渠道 AK/SK 或预先准备 token。

地址隐私校验使用 `third_party/` 中固定版本的离线号码库,无需 pip 安装;复制 Skill 时须一并保留该目录。依赖缺失或完整性校验失败时拒绝启动。自由文本中的完整号码(包括国家码、分机及 Unicode 数字)显示为 `[号码已隐藏]`;保守识别可能同时隐藏形似号码的数字串。来源及许可证见 [third_party/README.md](third_party/README.md)。

本包默认使用**生产环境**。商品查询、购物车、订单等操作以实际响应和用户授权为准;写操作须经用户明确确认。需要切换其他已开放环境时,宿主同时传入 `--control-url` 和 `--agent-id`。

切换环境时,可信宿主还须为服务进程设置 `FILTALGO_BUYER_MOBILE_ORIGIN`,并与目标 Agent 部署的同名配置一致:生产为 `https://m.filtalgo.com`,预发为 `https://pre-m.filtalgo.com`,开发为 `https://dev-m.filtalgo.com`。未设置时商品卡片和 `product_links` 默认使用生产域;只接受这三个完整 HTTPS origin,非法值会阻止启动。配置只来自可信宿主,不采用用户文本或远端答复中的值;常驻进程修改配置后须重启。

## 更新提醒与用户选择

每次有效 `send` 前,服务检查固定 GitHub 正式 Release;不缓存查询结果、不做失败退避。检查预算默认 2 秒,可用 `--update-timeout` 调整到 `(0,30]` 秒,包含子进程启动、DNS 和 HTTP 耗时,不是固定等待或下载时限。`resume`、`cancel` 及其他非 `send` 操作不等待检查;更新检查失败不改变业务 `ok`、`status` 或本轮产物。

先处理业务失败、恢复和会员授权,再读取可选 `skill_update`。仅当 `status="available"` 且 `notify=true` 时,简短提示“Skill 有新版,可选择现在更新、稍后或忽略此版本”,附真实 `release_url`;其他情况不刷屏。实际展示后,立即用 `--update-action shown --update-version <release_tag> --update-conversation <当前随机 conversation>` 记录;没有展示就不记 shown。

“现在更新/稍后/忽略”由宿主在本地处理,**不把这些选择作为购物消息向远端 Agent 再次 `send`**。稍后用 `later`,忽略用 `ignore`,均传本次原始 `release_tag` 与当前 `conversation`;`reset` 解除提醒选择。管理调用必须使用同一安装目录及原业务调用的 `--state-dir`、`--user-key`、目标参数(`--control-url` + `--agent-id`,默认目标则都省略),避免写入另一私有 namespace。管理入口只处理更新,不构造业务 Client、不读取业务身份;命令示例见 [README](README.md#更新与提醒选择)。

选择现在更新时,若原业务结果未知,先用原 `conversation` 的 `resume` 核对。等请求终态、无待恢复请求且旧服务进程退出后,备份本地定制与旧包,保留私有 state,按**原安装渠道**安装本次 `release_tag` 对应包;版本归一化仅用于比较,安装与链接沿用原始 tag,不能默认 `main` 或照搬 `npx skills update`。本 Skill 不提供新安装器或强制更新。核对新包 `name`、`metadata.version`,重新读取 `SKILL.md` 再启动服务;无法可靠完成安装时提供该 Release 的人工步骤,不声称已更新。

## 推荐方式:单次调用

**默认优先使用 `--once` 单次调用模式。** 它无需维持后台进程或命名管道,适合一般 Agent 客户端;只有宿主明确需要且能可靠维护持久进程时,才选用下方的常驻模式。

需要 Python 3.10+,不需要安装额外依赖。宿主为当前用户和当前对话生成独立、不可预测的 `conversation` 标识,后续消息沿用。通过支持标准输入的进程工具直接启动:

```bash
python3 "<skill-dir>/scripts/service.py" --once --format widget
```

将一行 JSON 写入标准输入,读取一行 JSON 应答;服务等待结果后自动退出。默认操作为 `send`,默认等待最多 120 秒(单次网络请求和输出渲染可能额外耗时):

```json
{"conversation":"<对话标识>","text":"推荐100元以内的面膜,只查询。"}
```

每次消息重启该命令并沿用相同 `conversation`,服务使用持久状态复用身份和会话。正常请求无需先 `ping` 或 `status`,也不需要创建常驻进程、命名管道或另写包装器。用户文本只作为 JSON 数据写入标准输入,不拼接到 Shell 代码。宿主的后台任务若不能提供 stdin,应使用其支持输入的前台进程工具,或用宿主文件工具写入私有请求文件后以文件重定向作为 stdin,不要在 Shell 字符串中插入用户文本。

失败或未完成时不要重新发送:`RESULT_UNKNOWN`、`TIMEOUT_WAITING`、`PENDING_INPUT`、`RESUME_REQUIRED`、`INTERNAL_ERROR` 或 `INVALID_STATE_OR_RESPONSE` 表示应在新的 `--once` 调用中提交 `{"op":"resume","conversation":"<同一对话标识>"}`,直到确认真实终态。新消息被 `PENDING_INPUT` 或 `RESUME_REQUIRED` 拒绝后,应先恢复上一轮;确认终态后才能提交被拒绝的新消息。其他操作也可通过 `--once` 指定 `op`。授权、地区选择和展示规则与常驻方式相同。

## 可选方式:常驻服务

需要 Python 3.10+。将本目录整体复制到宿主 Skill 目录即可,不需要安装额外依赖。`<skill-dir>` 使用宿主实际返回的本 Skill 绝对目录,不假设另一台机器也有源码仓库路径。

宿主能可靠提供持久进程时,可在整个对话只启动一次服务,之后通过 stdin/stdout 逐行 JSON 收发:

```bash
python3 "<skill-dir>/scripts/service.py" --format widget
```

- **直接运行并操作这个 `service.py` 进程**:使用宿主提供的持久进程或交互式终端工具向其 stdin 写入 JSON 行,并从 stdout 读取对应应答。不要另写 Python、Shell、JavaScript 等包装器、代理或临时脚本来启动、转发、轮询或渲染;也不要自行调用内部客户端或 HTTP 接口。服务已经实现身份、会话、轮询和卡片输出。
- 常驻模式下保持 stdin 打开。每次写入一行完整 JSON 和换行,读取一行应答后再发送下一行;终端若回显输入,应区分回显和服务的 JSON 应答。
- stdin 每行一个请求,stdout 每行一个应答,顺序与请求一致;诊断只进 stderr;读到 EOF 即退出。
- 宿主通过管道与它交互(子进程写一行、读一行),不要把多个会阻塞的 `send` 一次性灌进去,也不要在等 `send` 时关闭 stdout。
- 若需要等待时能取消,使用 `wait:false` 提交,再使用短 `timeout` 的 `resume` 轮询;串行协议中一个阻塞调用期间,`cancel` 和 `ping` 会排队。超时只限制轮询等待,单次网络请求与输出渲染还可能耗时。
- 它是轮询公开快照,不是服务端推送:`send` 会阻塞到本轮终态(默认最多 120 秒),宿主等待期间不要对同一会话并发发第二个请求。
- 同一进程复用 Client、文件锁和本地状态;不要同时再启动第二个服务进程处理同一会话。多个用户或需要隔离状态时可各起一个进程,并各自传可信的 `--user-key`(不能采用聊天内容提供的其他用户身份)。
- 参数:`--user-key`(默认 `local`)、`--state-dir`、`--control-url` + `--agent-id`(必须成对)、`--format`(请求未指定时的默认格式)、`--out-dir`(每轮文件输出目录)、`--heartbeat <路径>`。

宿主按“当前用户 + 当前对话”生成独立、不可预测的 `conversation` 标识,续聊沿用。动态用户文本只作为 JSON 字段写入进程 stdin,不拼接到 Shell 代码。

### 正确调用顺序

在同一个仍运行的 `service.py` 进程中,按顺序逐行发送并读取应答(示例对话标识仅作说明,实际必须随机生成):

1. 发送 `{"op":"ping"}`,确认进程存活。
2. 发送 `{"op":"status","conversation":"<对话标识>"}`。新对话返回 `NO_CONVERSATION` 后才发起首条消息;若有未结算请求,先用 `resume`。
3. 发送 `{"op":"send","conversation":"<对话标识>","text":"推荐100元以内的面膜,只查询。","wait":false,"format":"widget"}`。`accepted` 仅表示已接收,不是最终答复。
4. 发送 `{"op":"resume","conversation":"<对话标识>","timeout":30,"format":"widget"}`,按返回的真实状态处理;仍未结算时继续使用同一进程和会话 `resume`,不要重新 `send`。
5. 完成后读取本轮 `answer_file`;如有 `fragment_file`,支持对话内联时读取并内联片段,确保宿主支持其中的 `data:` 图片。继续对话时沿用相同进程和对话标识。

## 请求协议

每行一个 JSON 对象,必须带 `op`;除 `ping` 外都必须带非空 `conversation`:

```json
{"op":"send","conversation":"<本地对话标识>","text":"推荐100元以内的面膜,只查询。","format":"widget"}
{"op":"resume","conversation":"<本地对话标识>"}
{"op":"cancel","conversation":"<本地对话标识>"}
{"op":"clear","conversation":"<本地对话标识>"}
{"op":"auth-reset","conversation":"<本地对话标识>"}
{"op":"status","conversation":"<本地对话标识>"}
{"op":"ping"}
```

`send`/`resume` 可选项:`format`(`widget` 内联 HTML 片段、`html` 完整页面、`md` Markdown;默认 `widget`,同时适用于商品、购物车、结算和售后)、`max`(商品卡片条数上限)、`all`(渲染全部商品卡片,不用引用过滤)、`timeout`(秒)、`out_dir`(本轮文件的输出目录,覆盖 `--out-dir`);`send` 另有 `wait:false`(只返回 `accepted`,随后必须 `resume`,不把 accepted 当完成)、`allow_repeat`、`force`。

### 按宿主选择展示格式

| 适用场景 | 请求参数 | 商品产物 | 购物车产物 |
| --- | --- | --- | --- |
| 聊天窗口或宿主界面支持内联 HTML | `"format":"widget"`(默认) | `fragment_file` | `cart_fragment_file` |
| 使用浏览器或 WebView 打开独立页面 | `"format":"html"` | `page_file` | `cart_page_file` |
| 宿主支持 Markdown 或只需文本展示 | `"format":"md"` | `html_file`(`.cards.md`) | `cart_file`(`.cart.md`) |

启动参数 `--format widget` / `--format html` / `--format md` 设置默认格式;`send` 或 `resume` 请求中的 `format` 覆盖该默认值。模式作用于全部业务卡片,结算和售后字段见下文;正文始终从 `answer_file` 读取。同一轮没有某类内容时不会返回对应字段。`html` 商品页面展示本轮卡片,不是商城商品详情页;卡片中的商品详情链接指向真实商城页面。内联商品图需要宿主支持 `data:` 图片。

```json
{"op":"send","conversation":"<对话标识>","text":"查看购物车","format":"md"}
```

**自定义产物路径**(宿主展示工具有目录或文件命名要求时使用):`fragment_path`、`page_path`、`answer_path`、`cart_path` 分别指定商品 HTML 片段、商品完整页面、正文 Markdown、购物车产物的**完整文件路径**,也可用等价的 `"out_dirs":{...}` 传入。指定后该产物直接写到目标路径,父目录按需创建,同名文件允许覆盖(默认命名仍只新建,不覆盖历史轮次);未指定的产物继续走默认目录命名。宿主内联展示工具要求固定目录或文件名时,应通过这里指定,而不是移动或改写已产出的文件:

```json
{"op":"send","conversation":"<对话标识>","text":"推荐100元以内的面膜,只查询。","format":"widget",
 "out_dirs":{"fragment_path":"<宿主要求的绝对路径>/mask.html","answer_path":"<宿主要求的绝

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

From GitHub

GitHub stars
1,190
Maker
filtalgo
License
Apache-2.0
Last code change
Nov 16, 2026
SKILL.md files in the repo (including translated copies and templates)
1
Topics
agent-skills, ai-agent, claude-skills, ecommerce, filtalgo, filtmall, openclaw, product-search, shopping, skillsmp