dsh-goofish-mcp：闲鱼只读监控插件

前言¶

在 DeepSeek Harness (DSH) 的插件生态中，为智能体接入外部数据源通常需要编写额外的后端服务。对于闲鱼 (Xianyu / Goofish) 数据，直接调用 SDK 或编写爬虫存在维护成本高和鉴权复杂的问题。这个插件通过封装 goofish-cli 的 MCP 服务器，将闲鱼的只读数据能力直接暴露为标准工具，让 DSH 能够安全地访问商品信息、列表和聊天历史。

插件说明¶

• 名称：dsh-goofish-mcp
• 作者：zhengjy01
• 定位：闲鱼 (Xianyu / Goofish) read-only monitoring MCP for DeepSeek Harness
• 核心逻辑：驱动 goofish-cli 的 stdio 子进程，将闲鱼的只读数据能力封装为 mcp__goofish__* 工具。插件内部明确过滤了所有写操作工具，确保环境安全。

核心能力¶

插件提供以下已核实的数据访问工具：

• mcp__goofish__search_items：搜索闲鱼商品（真实返回结果）
• mcp__goofish__item_get / item_view：获取指定商品的详情
• mcp__goofish__item_list：列出当前账号在售的商品
• mcp__goofish__message_list_chats / message_history：获取会话列表及消息历史
• mcp__goofish__category_recommend / location_default / auth_status：分类推荐、默认位置、认证状态查询

只读边界¶

插件严格限制权限，明确不暴露以下写操作工具：
item_publish / item_delete / media_upload / message_send / auth_login / auth_reset_guard / message_watch / skills_install

安装与前置¶

在安装插件前，需要确保环境满足以下要求：

1. DeepSeek Harness 版本：≥ 0.1.5-rc.1
2. 安装 goofish-cli：

    uv tool install goofish-cli

3. 登录闲鱼：

    goofish auth login
    # 或使用二维码扫描登录
    goofish auth login --qr

4. 确认登录状态：

    goofish auth status

确保输出 `valid: true`。

安装插件¶

在 DeepSeek Harness 中执行以下命令安装插件：

dsh plugin --profile web add dsh-goofish-mcp

安装完成后，重启 dsh web 以激活插件。

配置与使用¶

• 配置文件：配置存放在 ~/.dsh/dsh-xianyu (0600)。
• 认证管理：登录 Cookie 由 goofish-cli 管理，本插件不读取，由 CLI 统一维护。
• DSH 内部工具：
  • goofish_status：查看连接/注册/只读状态
  • goofish_config：配置 stdio 命令/参数/只读开关
  • goofish_test：测试连接并列出只读工具
  • goofish_tools：列出当前注册的只读工具列表

注意事项¶

• 插件以 DSH 进程的当前权限运行，请确保在使用前检查源码与许可证。
• 该插件仅提供只读监控能力，不适合用于需要频繁交互或发布内容的场景。

结语¶

该插件为 DSH 提供了标准化的闲鱼数据访问能力，适合用于数据监控、竞品分析或作为智能体的知识库来源。

• GitHub 仓库
• 插件目录