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 倉庫
• 插件目錄