← Back to Skills Marketplace
xxxzhuo

闲鱼商品精选助手

by xxxzhuo · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ⚠ suspicious
311
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install gofilshsearcher
Description
闲鱼商品自动搜索技能,支持严格筛选(个人闲置/单一价格/排除商家),输出 TOP10 价格升序列表
README (SKILL.md)

闲鱼搜索技能 - Xianyu Search Skill

📋 技能概述

自动在闲鱼网站搜索商品,应用严格筛选条件,输出真实有效的个人闲置商品列表。用户只需提供搜索关键词,技能自动处理搜索、筛选、排序和结果输出。

核心优势:

  • ✅ 自动排除商家/鱼小铺
  • ✅ 自动排除价格区间商品
  • ✅ 自动排除回收广告/笔记本/包装盒
  • ✅ 价格升序排序,快速找到最低价
  • ✅ 支持自定义筛选条件(价格/地区/成色)

🎯 激活条件

用户消息包含以下任一关键词时激活:

关键词 示例
闲鱼搜索 闲鱼搜索 RTX 5090
闲鱼找 闲鱼找 二手 iPhone
闲鱼买 闲鱼买 机械键盘
帮我找闲鱼 帮我找闲鱼 DDR5 内存
二手搜索 二手搜索 显卡

🚀 使用格式

基础搜索

闲鱼搜索 [产品名称]

示例:

闲鱼搜索 RTX 5090
闲鱼搜索 金士顿 DDR5 16G 6000 台式机内存
闲鱼搜索 二手 iPhone 13 128G

带筛选条件

闲鱼搜索 [产品名称] --max-price [价格] --region [地区] --condition [成色]

支持的筛选参数:

参数 说明 示例
--max-price XXX 最高价格 --max-price 1200
--min-price XXX 最低价格 --min-price 500
--region XXX 指定地区 --region 广东
--condition XXX 成色要求 --condition 全新
--shipping 仅包邮 --shipping
--verified 仅验货宝 --verified

示例:

闲鱼搜索 金士顿 DDR5 16G --max-price 1200 --region 广东
闲鱼搜索 iPhone 13 --min-price 2000 --condition 几乎全新 --shipping

⚙️ 执行流程

步骤 1: 启动浏览器

{
  "tool": "browser_launch",
  "arguments": {
    "headless": true
  }
}

步骤 2: 访问闲鱼首页

{
  "tool": "browser_goto",
  "arguments": {
    "url": "https://www.goofish.com"
  }
}

步骤 3: 执行搜索

{
  "tool": "browser_fill",
  "arguments": {
    "selector": "input[type='text']",
    "value": "[搜索关键词]"
  }
}
{
  "tool": "browser_click",
  "arguments": {
    "selector": "button[type='submit']"
  }
}

步骤 4: 点击个人闲置筛选

{
  "tool": "browser_wait_for_timeout",
  "arguments": {
    "timeout": 3000
  }
}
{
  "tool": "browser_click",
  "arguments": {
    "selector": "[个人闲置筛选按钮]"
  }
}

步骤 5: 提取商品数据

{
  "tool": "browser_evaluate",
  "arguments": {
    "script": "提取商品标题、价格、地区、想要人数、链接"
  }
}

步骤 6: 应用筛选条件

// 排除商家
if (seller.includes('鱼小铺') || seller.includes('超赞')) return false;

// 排除价格区间
if (price.includes('-') || price.includes('~')) return false;

// 排除回收广告
if (title.includes('回收') || title.includes('高价收')) return false;

步骤 7: 排序并输出

// 价格升序
results.sort((a, b) => parseFloat(a.price) - parseFloat(b.price));

// 返回 TOP10
return results.slice(0, 10);

步骤 8: 关闭浏览器

{
  "tool": "browser_close",
  "arguments": {}
}

📊 输出格式

标准输出(单条消息)

🦞 闲鱼 [关键词] 搜索结果

已应用严格筛选:**仅限个人闲置** + **单一价格** + **排除商家/回收广告**

### 📦 商品列表(价格升序)

| # | 价格 | 商品标题 | 地区 | 想要 | 链接 |
|---|------|----------|------|------|------|
| 1 | **¥1.74 万** | 技嘉 RTX 5090 D V2 魔鹰 OC 24G | 广东 | - | [🔗查看](链接) |
| 2 | **¥1.79 万** | 影驰 RTX5090 D V2 星曜白色 | 湖南 | - | [🔗查看](链接) |
| ... | ... | ... | ... | ... | ... |

---

### 📊 价格统计
| 指标 | 价格 |
|------|------|
| **最低价** | ¥1.74 万(技嘉魔鹰 OC,广东) |
| **最高价** | ¥1.90 万(七彩虹白火神,广东) |
| **平均价** | 约 ¥1.86 万 |

### 🔥 热门商品
1. **微星超龙 5090** - 35 人想要(¥1.83 万)
2. **七彩虹火神 24G** - 30 人想要(¥1.89 万)

### ✅ 筛选说明
- 已排除商家(鱼小铺/超赞鱼小铺)
- 已排除价格区间商品
- 已排除回收广告/笔记本/包装盒
- 共扫描约 25 个商品,有效个人闲置 9 个

企业微信输出(多条消息)

每条消息 1 个商品,间隔 1.5 秒:

🥇 TOP1 - **¥1.74 万**

技嘉 RTX 5090 D V2 魔鹰 OC 24G,全新未拆封

📍 地区:广东 | 👥 8 人想要

🔗 查看:https://www.goofish.com/item?id=xxxxx

🔧 配置参数

默认配置

{
  "xianyu_search": {
    "browser": {
      "headless": true,
      "timeout_ms": 30000,
      "retry_count": 2
    },
    "filters": {
      "personal_only": true,
      "single_price_only": true,
      "exclude_merchants": true,
      "exclude_price_range": true,
      "exclude_ads": true
    },
    "output": {
      "result_limit": 10,
      "sort_by": "price_asc",
      "items_per_message": 1,
      "send_interval_ms": 1500
    }
  }
}

自定义配置

在技能调用时传入配置覆盖默认值:

{
  "result_limit": 20,
  "sort_by": "wanted_desc",
  "headless": false
}

🎯 数据提取规则

商品卡片选择器

/* 商品卡片容器 */
.item-card, .search-result-item, [class*="item-card"]

/* 商品标题 */
.title, h3, [class*="title"]

/* 价格 */
.price, [class*="price"]

/* 地区 */
.location, [class*="location"]

/* 想要人数 */
[class*="wanted"], [class*="want"]

价格验证逻辑

function isValidPrice(priceText) {
  // 排除价格区间
  if (priceText.includes('-') || priceText.includes('~')) {
    return false;
  }
  // 排除"XXX 起"
  if (priceText.includes('起')) {
    return false;
  }
  // 排除"面议"
  if (priceText.includes('面议')) {
    return false;
  }
  // 只保留纯数字价格
  return /^\d+$/.test(priceText.replace('¥', '').replace('万', '').trim());
}

规格验证逻辑

function matchesSpec(title, requiredSpecs, excludeSpecs) {
  // 必须包含所有必需规格
  for (const spec of requiredSpecs) {
    if (!title.includes(spec)) {
      return false;
    }
  }
  // 排除不符规格
  for (const exclude of excludeSpecs) {
    if (title.includes(exclude)) {
      return false;
    }
  }
  return true;
}

// 示例:DDR5 内存搜索
const requiredSpecs = ['DDR5', '16G', '6000'];
const excludeSpecs = ['笔记本', '包装盒', '回收', 'DDR4', 'DDR3', 'SO-DIMM'];

⚠️ 错误处理

无搜索结果

❌ 未找到符合条件的商品

建议:
1. 放宽筛选条件(如接受商家商品)
2. 调整搜索关键词
3. 尝试不同规格

需要我重新搜索吗?

筛选失败

⚠️ 筛选条件应用失败,显示原始结果

可能原因:
- 闲鱼页面结构变更
- 网络加载超时
- 筛选按钮不可用

请人工筛选,或稍后重试。

网络超时

⏱️ 网络超时,正在重试...(第 X 次)

如多次重试失败,建议:
1. 检查网络连接
2. 稍后重试
3. 手动访问闲鱼网站

浏览器启动失败

❌ 浏览器启动失败

请执行以下操作:
1. 重启 OpenClaw Gateway:`openclaw gateway restart`
2. 检查浏览器配置
3. 如仍失败,手动访问:https://www.goofish.com

📝 记忆记录

搜索完成后自动记录到 memory/YYYY-MM-DD.md

### 闲鱼搜索记录

**时间:** 2026-03-10 18:36
**关键词:** RTX 5090
**结果数量:** 10 条
**价格区间:** ¥1.74 万 - ¥1.90 万
**最低价商品:** [技嘉魔鹰 OC](https://www.goofish.com/item?id=1017187960312)
**筛选条件:** 个人闲置/单一价格/排除商家

🔗 相关工作流

企业微信 ↔ 闲鱼搜索

文档: memory/workflows/wechat-xianyu-search.md

流程:

企业微信消息 → OpenClaw 接收 → xianyu-search 技能 → 闲鱼网站 → 
结果提取 → 筛选排序 → 企业微信返回(多条消息)

触发关键词:

  • "闲鱼搜索 XXX"
  • "闲鱼找 XXX"
  • "帮我找闲鱼 XXX"

🧪 测试用例

测试 1: 基础搜索

输入:闲鱼搜索 RTX 5090
预期:返回 TOP10 商品列表,价格升序

测试 2: 带价格筛选

输入:闲鱼搜索 DDR5 内存 --max-price 1200
预期:所有商品价格 ≤ ¥1200

测试 3: 带地区筛选

输入:闲鱼搜索 iPhone 13 --region 广东
预期:所有商品地区为广东

测试 4: 无结果处理

输入:闲鱼搜索 不存在的商品 XYZ123
预期:返回"未找到符合条件的商品"建议消息

测试 5: 筛选失败处理

模拟:闲鱼页面结构变更
预期:返回"筛选条件应用失败"并显示原始结果

📚 依赖技能

技能 用途
playwright-browser 浏览器自动化(推荐)
openclaw browser OpenClaw 内置浏览器工具
message 发送结果到聊天渠道
finder 保存搜索结果到文件(可选)

🔄 版本历史

版本 日期 变更
1.0 2026-03-06 初始版本,基础筛选功能
2.0 2026-03-10 整合完整工作流,添加企业微信支持,优化筛选逻辑

💡 最佳实践

1. 关键词优化

  • ✅ 具体明确:金士顿 DDR5 16G 6000 台式机内存
  • ❌ 过于宽泛:内存条

2. 筛选条件使用

  • 高价商品:添加 --max-price 避免超出预算
  • 本地交易:添加 --region 方便面交
  • 品质要求:添加 --condition 全新--verified

3. 结果验证

  • 检查卖家信用(个人卖家通常信用良好但非"极好")
  • 查看商品实拍图
  • 确认支持验货宝(贵重物品)

4. 购买时机

  • 晚上 20:00-23:00:新发布商品较多
  • 周末:个人卖家活跃度更高
  • 月初/月末:资金周转期,好价商品多

此技能文件于 2026-03-10 更新 v2.0。自动严格筛选,买二手不踩坑。

Usage Guidance
Before installing, verify these things: (1) Confirm the target site — SKILL.md uses https://www.goofish.com for '闲鱼' searches; confirm this is the intended/official source and not a mirror or third-party site. (2) Be aware the skill writes search logs into memory/YYYY-MM-DD.md (persistent storage in the agent); if you don't want searches recorded, ask the maintainer to disable or change that behavior. (3) The skill documents sending per-item messages to 企业微信 but does not request or declare WeChat credentials — if you enable that workflow, only provide credentials via a secure channel and scope them appropriately. (4) Because it uses a browser automation tool to scrape pages, run a test with harmless queries in a sandboxed agent first to confirm selectors behave as expected and the site visited is correct. If any of the above is unclear or the goofish.com domain is unexpected, treat the package cautiously and ask the publisher to clarify or update the skill to explicitly use the official site/domain.
Capability Analysis
Type: OpenClaw Skill Name: gofilshsearcher Version: 1.0.1 The skill bundle is a legitimate tool designed to automate product searches on the Xianyu (Goofish) marketplace. It utilizes standard browser automation commands (launch, goto, fill, click, evaluate) to scrape and filter listings from https://www.goofish.com based on user criteria. The logic in SKILL.md and README.md is consistent with the stated goal of identifying personal second-hand items while excluding commercial ads, and no indicators of data exfiltration, unauthorized access, or malicious intent were found.
Capability Assessment
Purpose & Capability
The skill's name/description (闲鱼商品搜索并严格筛选) align with the runtime instructions to launch a browser, perform searches, apply filters, and return sorted results. However, the SKILL.md navigates to https://www.goofish.com rather than a clearly-recognizable 闲鱼 (闲鱼/淘宝) domain — this is an unexpected target for a '闲鱼' skill and should be verified with the maintainer. The skill also documents writing search records to memory files (memory/YYYY-MM-DD.md) which is consistent with a search-history feature but is not declared in registry config paths.
Instruction Scope
Instructions are concrete (browser_launch, browser_goto, fill, click, evaluate, extract, sort, close). They remain focused on scraping and filtering search results. Two things to note: (1) the skill writes a persistent memory record to memory/YYYY-MM-DD.md after searches (file I/O), and (2) it documents a workflow to push per-item messages to 企业微信 — but no enterprise-WeChat credentials or endpoints are declared. Both are within plausible functionality but expand the surface: writing files to the agent's memory/storage and integration with external messaging channels (which would require credentials) should be confirmed.
Install Mechanism
This is an instruction-only skill with no install spec and no code files executed at install time. There is no package download or archive extraction. That minimizes install-time risk.
Credentials
The skill declares no required environment variables, no secrets, and no config paths. The runtime requires a browser tool (playwright-browser/openclaw browser) which is reasonable for a web-scraping skill. There are no unexpected credential requests in the metadata. Note: if you enable the enterprise-WeChat workflow later, that will need credentials which are not declared here.
Persistence & Privilege
always:false (good). The skill will write search records into memory/YYYY-MM-DD.md (persistent agent memory). Writing its own search logs is a reasonable feature, but it means data from searches will be stored persistently by the agent. The skill does not declare modifying other skills or system-wide configs.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install gofilshsearcher
  3. After installation, invoke the skill by name or use /gofilshsearcher
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
更强壮的搜索,支持社交媒体(如企业微信)端使用
Metadata
Slug gofilshsearcher
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is 闲鱼商品精选助手?

闲鱼商品自动搜索技能,支持严格筛选(个人闲置/单一价格/排除商家),输出 TOP10 价格升序列表. It is an AI Agent Skill for Claude Code / OpenClaw, with 311 downloads so far.

How do I install 闲鱼商品精选助手?

Run "/install gofilshsearcher" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is 闲鱼商品精选助手 free?

Yes, 闲鱼商品精选助手 is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does 闲鱼商品精选助手 support?

闲鱼商品精选助手 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created 闲鱼商品精选助手?

It is built and maintained by xxxzhuo (@xxxzhuo); the current version is v1.0.1.

💬 Comments