← 返回 Skills 市场
1688aiinfra

alphashop-sel-product-search

作者 1688AiInfra · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ⚠ suspicious
120
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install alphashop-sel-product-search
功能描述
商品搜索API SKILL：通过关键词搜索发现Amazon/TikTok平台商品。 支持价格、销量、评分、上架时间等多维度筛选条件。 通过 AlphaShop REST API 调用遨虾AI选品系统的商品搜索服务。
使用说明 (SKILL.md)

配置

环境变量

需要配置 AlphaShop API 凭证。在 OpenClaw config 中设置：

{
  skills: {
    entries: {
      "alphashop-sel-newproduct": {
        env: {
          ALPHASHOP_ACCESS_KEY: "你的AccessKey",
          ALPHASHOP_SECRET_KEY: "你的SecretKey"
        }
      }
    }
  }
}

如何获取 API Key

获取途径

本 skill 使用 AlphaShop/遨虾平台的 API 服务，需要申请以下凭证：

  • ALPHASHOP_ACCESS_KEY - API 访问密钥
  • ALPHASHOP_SECRET_KEY - API 密钥

申请步骤

  1. 联系平台方

    • 如果您是 1688 或阿里内部用户，请联系 AlphaShop/遨虾 平台管理员
    • 平台可能需要您提供：
      • 公司信息
      • 使用场景说明
      • 预期调用量

  2. 获取凭证

    • 平台审核通过后会提供：
      • Access Key（访问密钥）
      • Secret Key（密钥）

  3. 配置到环境

    • 按照上面的配置方式设置环境变量

缺少凭证时的提示

如果运行 skill 时未配置凭证，会看到详细的配置指南：

🔐 需要 AlphaShop API 凭证

本 skill 需要以下凭证才能使用：
  • ALPHASHOP_ACCESS_KEY  - API 访问密钥
  • ALPHASHOP_SECRET_KEY  - API 密钥

📋 如何获取凭证：
1. 联系 AlphaShop/遨虾 平台获取 API 凭证
2. 配置环境变量或 OpenClaw 配置
3. 重新运行命令

商品搜索API SKILL

通过 AlphaShop REST API 调用1688遨虾AI选品系统的商品搜索服务，支持关键词搜索，覆盖Amazon和TikTok平台。

CRITICAL: 参数收集策略

当用户请求搜索但未提供必需参数（platform 和 region）时，必须使用 AskUserQuestion 工具引导用户选择。禁止使用任何默认值。

必需参数检查

关键词搜索 (scripts/search.py)：

  • --keyword: 必填（从用户输入提取）
  • --platform: 必填 ⚠️ 如果缺失→询问用户
  • --region: 必填 ⚠️ 如果缺失→询问用户

参数询问流程

Step 1: 询问平台（如果用户未指定 platform）

使用 AskUserQuestion 提供选项：

  • Amazon - 描述：覆盖美国、英国、日本、德国、法国、意大利、西班牙、加拿大8个市场
  • TikTok - 描述：覆盖西班牙、菲律宾、法国、印尼、墨西哥、越南、德国、日本、泰国、新加坡、巴西、意大利、美国、英国、马来西亚15个市场

Step 2: 询问区域（如果用户未指定 region）

根据选择的平台，使用 AskUserQuestion 提供对应区域选项：

Amazon 区域：

  • US - 美国
  • UK - 英国
  • JP - 日本
  • DE - 德国
  • FR - 法国
  • IT - 意大利
  • ES - 西班牙
  • CA - 加拿大

TikTok 区域：

  • ES - 西班牙
  • PH - 菲律宾
  • FR - 法国
  • ID - 印尼
  • MX - 墨西哥
  • VN - 越南
  • DE - 德国
  • JP - 日本
  • TH - 泰国
  • SG - 新加坡
  • BR - 巴西
  • IT - 意大利
  • US - 美国
  • GB - 英国
  • MY - 马来西亚

Step 3: 执行搜索

收集完所有必需参数后，构建完整命令执行。

执行示例

❌ 错误示例

用户: "搜索 yoga pants"
Claude: 直接执行 python3 scripts/search.py --keyword "yoga pants" --platform amazon --region US
问题: 未询问用户，擅自使用默认值

✅ 正确示例

用户: "搜索 yoga pants"
Claude: 使用 AskUserQuestion 询问平台 (Amazon/TikTok)
用户: 选择 Amazon
Claude: 使用 AskUserQuestion 询问区域 (US/UK/JP...)
用户: 选择 US
Claude: 执行 python3 scripts/search.py --keyword "yoga pants" --platform amazon --region US

✅ 部分参数已提供

用户: "在 Amazon 搜索 phone"
Claude: 识别到 platform=amazon，使用 AskUserQuestion 询问区域
用户: 选择 JP
Claude: 执行 python3 scripts/search.py --keyword "phone" --platform amazon --region JP

✅ 所有参数齐全

用户: "在 Amazon 美国市场搜索 phone"
Claude: 识别到所有必需参数，直接执行搜索
Claude: python3 scripts/search.py --keyword "phone" --platform amazon --region US

功能说明

核心功能

关键词搜索 (scripts/search.py)

  • 关键词搜索：根据关键词搜索目标平台的商品
  • 多维度筛选：支持价格、销量、评分、上架时间等筛选条件
  • 多平台支持：Amazon（美国、英国、日本等）、TikTok（印尼、泰国等）
  • 丰富商品信息：返回商品详情、供应商信息、规格参数、物流选项等

支持的平台和区域

Amazon平台：

  • 美国 (US)
  • 英国 (UK)
  • 日本 (JP)
  • 德国 (DE)
  • 法国 (FR)
  • 意大利 (IT)
  • 西班牙 (ES)
  • 加拿大 (CA)

TikTok平台：

  • 西班牙 (ES)
  • 菲律宾 (PH)
  • 法国 (FR)
  • 印度尼西亚 (ID)
  • 墨西哥 (MX)
  • 越南 (VN)
  • 德国 (DE)
  • 日本 (JP)
  • 泰国 (TH)
  • 新加坡 (SG)
  • 巴西 (BR)
  • 意大利 (IT)
  • 美国 (US)
  • 英国 (GB)
  • 马来西亚 (MY)

使用方法

基础搜索

# 搜索Amazon美国市场的手机
python3 scripts/search.py --keyword "phone" --platform amazon --region US

# 搜索TikTok印尼市场的瑜伽裤
python3 scripts/search.py --keyword "yoga pants" --platform tiktok --region ID

价格筛选

# 搜索价格在10-100美元的商品
python3 scripts/search.py --keyword "phone" --platform amazon --region US --min-price 10 --max-price 100

销量筛选

# 搜索月销量在100-10000的商品
python3 scripts/search.py --keyword "phone" --platform amazon --region US --min-sales 100 --max-sales 10000

评分筛选

# 搜索评分4.0-5.0的高评分商品
python3 scripts/search.py --keyword "phone" --platform amazon --region US --min-rating 4.0 --max-rating 5.0

上架时间筛选

# 搜索90天内上架的新品
python3 scripts/search.py --keyword "phone" --platform amazon --region US --listing-time 90

# listing-time 支持：90, 180, 365

综合筛选

# 组合多个筛选条件
python3 scripts/search.py \
  --keyword "phone" \
  --platform amazon \
  --region US \
  --min-price 10 \
  --max-price 100 \
  --min-sales 100 \
  --min-rating 4.0 \
  --listing-time 90 \
  --count 20

指定返回数量

# 返回最多50个商品（默认10个）
python3 scripts/search.py --keyword "phone" --platform amazon --region US --count 50

参数说明

参数 必填 说明 示例
--keyword 是 搜索关键词 "phone", "yoga pants"
--platform 是 目标平台 amazon, tiktok
--region 是 目标国家/地区代码 US, UK, JP, ID, TH, ES, PH, FR, MX, VN, DE, SG, BR, IT, GB, MY
--min-price 否 最低价格（美元） 10.0
--max-price 否 最高价格（美元） 100.0
--min-sales 否 最低30天销量 100
--max-sales 否 最高30天销量 10000
--min-rating 否 最低评分（0-5.0） 4.0
--max-rating 否 最高评分（0-5.0） 5.0
--listing-time 否 上架时间（天） 90, 180, 365
--count 否 返回商品数量（默认10） 20
--user-id 否 用户ID（默认"123456"） "your_user_id"

返回数据结构

成功响应

{
  "success": true,
  "code": "SUCCESS",
  "message": "成功",
  "data": {
    "totalCount": 50,
    "productList": [
      {
        "itemId": "B08N5WRWNW",
        "title": "Apple iPhone 12 Pro Max",
        "category": "Cell Phones",
        "price": 899.99,
        "currency": "USD",
        "moq": 1,
        "stock": 500,
        "rating": 4.8,
        "salesVolume": 5000,
        "reviewCount": 1234,
        "images": ["https://..."],
        "supplier": {
          "supplierId": "AXXXXX",
          "supplierName": "Apple Store",
          "country": "US",
          "city": "Cupertino",
          "yearsOnPlatform": 10,
          "mainProducts": "Electronics",
          "responseRate": 98.5,
          "responseTime": "within 2 hours",
          "deliveryRate": 99.0
        },
        "specifications": [
          {"name": "Color", "value": "Pacific Blue"},
          {"name": "Storage", "value": "256GB"}
        ],
        "logisticsOptions": [
          {
            "method": "Standard Shipping",
            "estimatedCost": 5.99,
            "estimatedTime": "3-5 business days",
            "destination": "US"
          }
        ],
        "advantages": [
          "Fast shipping",
          "High quality",
          "Verified supplier"
        ]
      }
    ]
  }
}

错误响应

{
  "success": false,
  "code": "KEYWORD_EMPTY",
  "message": "搜索关键词不能为空",
  "data": null
}

错误码说明

错误码 说明 解决方案
KEYWORD_EMPTY 关键词为空 提供有效的搜索关键词
TARGET_PLATFORM_ILLEGAL 平台参数非法 使用 amazon 或 tiktok
TARGET_COUNTRY_ILLEGAL 国家代码非法或平台不支持 检查平台与国家的匹配关系
PRODUCT_LISTING_TIME_ERROR 上架时间参数错误 使用 90/180/365
PRODUCT_FILTER_PARAMS_ERROR 筛选参数错误 检查价格/销量/评分区间
PRODUCT_RECALL_EMPTY 未搜索到符合条件的商品 放宽筛选条件

接口信息

商品搜索 API

  • 接口地址：POST https://api.alphashop.cn/ai.sel.global1688.productSearchApi/1.0
  • 环境：生产环境（Production）
  • 认证方式：JWT Token (HS256)
  • 请求格式：JSON
  • 响应格式：JSON
  • 超时时间：建议 30-60 秒

认证配置

需要配置 AlphaShop API 凭证：

环境变量：

export ALPHASHOP_ACCESS_KEY='your-access-key'
export ALPHASHOP_SECRET_KEY='your-secret-key'

OpenClaw 配置：

{
  "skills": {
    "entries": {
      "alphashop-sel-product-search": {
        "env": {
          "ALPHASHOP_ACCESS_KEY": "your-access-key",
          "ALPHASHOP_SECRET_KEY": "your-secret-key"
        }
      }
    }
  }
}

凭证获取途径：https://www.alphashop.cn/seller-center/apikey-management

注意事项

  1. 关键词风控：某些敏感关键词可能被风控系统拦截
  2. 数据实时性：商品信息可能存在延迟（通常\x3C24小时）
  3. 筛选条件：过于严格的筛选可能导致无结果
  4. 性能考虑：复杂查询可能耗时较长（通常\x3C5秒）
  5. 平台限制：确保平台和国家组合在支持列表中
  6. 评分范围：评分必须在 0-5.0 之间
  7. 价格单位：所有价格以美元计价

使用场景

1. 市场调研

找出目标市场的热门商品和价格区间

python3 scripts/search.py --keyword "yoga mat" --platform amazon --region US --count 50

2. 选品分析

筛选高评分、高销量的优质商品

python3 scripts/search.py --keyword "fitness equipment" --platform amazon --region US \
  --min-rating 4.5 --min-sales 500 --count 30

3. 新品发现

寻找90天内上架的新品

python3 scripts/search.py --keyword "smart watch" --platform amazon --region US \
  --listing-time 90 --count 20

4. 价格竞争分析

分析特定价格区间的商品分布

python3 scripts/search.py --keyword "headphone" --platform amazon --region US \
  --min-price 20 --max-price 50 --count 40

技术支持

  • 问题反馈：提交 Issue 到 global-skill 仓库
  • 文档更新：参考 references/api.md
  • 测试计划：参考项目中的测试用例

版本历史

  • v1.0 (2026-03-17)
    • 初始版本
    • 支持基础关键词搜索
    • 支持多维度筛选（价格、销量、评分、上架时间）
    • 支持 Amazon 和 TikTok 平台
安全使用建议
What to check before installing/using this skill: - Source verification: The skill's source/homepage is missing. Confirm the publisher and that alphashop.cn is a legitimate service you trust before supplying API keys. - Credentials: The SKILL.md and README require ALPHASHOP_ACCESS_KEY and ALPHASHOP_SECRET_KEY, but the registry metadata incorrectly lists no required env vars — treat this as a metadata bug and assume the skill will read those env vars or accept them via CLI. Do not reuse high-privilege keys: create a scoped/test key if possible. - Dependencies: The included Python script uses requests and PyJWT but the skill does not declare dependencies. Install dependencies in an isolated environment (virtualenv) and review the script locally before running. - Logging of inputs: The script prints the full request payload to stdout (including userId and search parameters). Avoid putting secrets into fields that get printed; rotate keys if exposed to logs. - Network calls: The script makes outbound HTTPS POSTs to api.alphashop.cn. If organizational policy restricts external calls, block or review the endpoint. Consider testing with a network sandbox or verifying the endpoint's TLS certificate and ownership. - Inconsistencies: Ask the maintainer to (1) correct registry metadata to list required env vars and dependencies, (2) provide a homepage/source repository, and (3) confirm the correct process for obtaining API keys. Because of the metadata/dependency inconsistencies and missing source, treat this skill as suspicious until the publisher/source and required environment/dependency declarations are clarified.
功能分析
Type: OpenClaw Skill Name: alphashop-sel-product-search Version: 1.0.1 The skill bundle provides a legitimate interface for searching products on Amazon and TikTok via the AlphaShop API. The core logic in `scripts/search.py` performs standard HTTP requests with JWT authentication, includes parameter validation, and uses appropriate timeouts. The documentation and instructions in `SKILL.md` are well-structured, focusing on guiding the AI agent to collect necessary parameters from the user rather than using unsafe defaults. No indicators of data exfiltration, malicious execution, or harmful prompt injection were found.
能力评估
ℹ Purpose & Capability
The skill claims to search Amazon/TikTok via the AlphaShop REST API and the included Python script implements exactly that (HTTP POST to https://api.alphashop.cn). That capability is coherent with the name/description. However, the registry metadata lists no required environment variables or primary credential, while README/SKILL.md and scripts/search.py explicitly require ALPHASHOP_ACCESS_KEY and ALPHASHOP_SECRET_KEY (or CLI --app-key/--app-secret). This metadata mismatch is unexpected and should be explained.
✓ Instruction Scope
Runtime instructions direct the agent to collect platform/region from the user (via AskUserQuestion) and to run scripts/search.py with collected parameters. The script only performs parameter validation, constructs a JSON payload, generates a JWT using the provided keys, and posts to the AlphaShop endpoint. It does not attempt to read unrelated system files or other credentials. Note: the script prints the request payload to stdout (it will echo request parameters), which can expose user-supplied data in logs.
ℹ Install Mechanism
There is no install spec (instruction-only / no package installation), which limits disk writes. However the skill includes a non-trivial Python script that depends on external libraries (requests, PyJWT). Those dependencies are not declared in the registry metadata or README. The absence of declared dependencies is an operational gap (may fail at runtime or cause users to pip-install packages themselves).
⚠ Credentials
The script and documentation require ALPHASHOP_ACCESS_KEY and ALPHASHOP_SECRET_KEY for API calls (used to generate JWT). Requesting those two credentials is proportionate to calling AlphaShop. However the registry/manifest claims 'required env vars: none' and 'primaryEnv: none' — a direct inconsistency. The skill will access those environment variables at runtime (and accept them via CLI) but the platform metadata does not advertise that. That mismatch is a red flag because it may lead users to inadvertently supply credentials without realizing which skill will use them.
✓ Persistence & Privilege
The skill does not request permanent presence (always: false), does not modify other skills or global config, and has no installation step that writes persistent system-wide artifacts. It runs as a script and performs a network call — normal for this functionality.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install alphashop-sel-product-search
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /alphashop-sel-product-search 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.1
alphashop-sel-product-search 1.0.1 - 首次发布：支持通过关键词在 Amazon/TikTok 不同区域多维度搜索商品。 - 参数校验更严格：platform 和 region 缺失时强制通过交互方式引导用户选择，禁止默认值。 - 丰富筛选条件：支持价格、销量、评分、上架时间等多种组合筛选。 - 详细 API 调用与请求参数指南，涵盖环境配置和凭证申请说明。 - 返回完整商品、供应商、物流等信息，标准化响应结构与错误码表。 - 覆盖 8 个 Amazon 区域和 15 个 TikTok 区域，多场景用法示例。
元数据
Slug alphashop-sel-product-search
版本 1.0.1
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

alphashop-sel-product-search 是什么？

商品搜索API SKILL：通过关键词搜索发现Amazon/TikTok平台商品。 支持价格、销量、评分、上架时间等多维度筛选条件。 通过 AlphaShop REST API 调用遨虾AI选品系统的商品搜索服务。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 120 次。

如何安装 alphashop-sel-product-search？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install alphashop-sel-product-search」即可一键安装，无需额外配置。

alphashop-sel-product-search 是免费的吗？

是的，alphashop-sel-product-search 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

alphashop-sel-product-search 支持哪些平台？

alphashop-sel-product-search 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 alphashop-sel-product-search？

由 1688AiInfra（@1688aiinfra）开发并维护，当前版本 v1.0.1。

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463815 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259802 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200680 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191345 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190333 · by oswalpalash

💬 留言讨论