← Back to Skills Marketplace
search-1688-supplier
by
1688AiInfra
· GitHub ↗
· v1.0.4
· MIT-0
111
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install search-1688-supplier
Description
通过 AlphaShop API 搜索和筛选1688供应商。支持三种输入方式: 1688商品链接(查找特定商品的供应商)、图片URL(以图搜货)、 文字关键词(按关键词搜索供应商)。支持按最高价格、最大起批量、 最低48H发货率进行筛选。适用于查找1688供应商、搜索工厂、 以图找商、找供应商、搜商家等场景。
Usage Guidance
This skill appears to implement exactly what it says: it calls AlphaShop APIs and filters results locally. Before installing or running it, note the following:
- You must provide ALPHASHOP_ACCESS_KEY and ALPHASHOP_SECRET_KEY; the code will exit if they are missing. The registry metadata incorrectly omits these required env vars — do not rely on the registry to surface required secrets.
- Supplying the secret key gives the skill the ability to generate JWTs and call AlphaShop on your behalf. Only provide keys you trust the recipient/service with; prefer using credentials scoped/rotated specifically for this integration.
- The script sends user-supplied URLs (including image URLs) to AlphaShop. Do not pass any private/local URLs or sensitive links you don't want sent to an external service.
- The package owner/homepage is unknown. If you need higher assurance, ask the publisher for provenance (source repo, project homepage) or run the code in an isolated environment to inspect behavior before supplying secrets.
- If you proceed, install dependencies in a virtualenv and consider creating AlphaShop API credentials with minimal permissions and the ability to revoke them quickly.
If you want, I can: (1) show the full remaining portion of scripts/search.py (it was truncated in the manifest) to double-check there are no hidden behaviors; (2) suggest a checklist for verifying the publisher; or (3) produce a minimal sandboxed command to run the script safely.
Capability Analysis
Type: OpenClaw Skill
Name: search-1688-supplier
Version: 1.0.4
The skill is a legitimate tool for searching 1688 suppliers via the AlphaShop API. The main script (`scripts/search.py`) uses standard libraries to handle API authentication via JWT and perform searches based on text, image URLs, or product links. The instructions in `SKILL.md` provide operational guidance for the AI agent without any evidence of prompt injection or malicious intent. No data exfiltration, unauthorized execution, or obfuscation was found.
Capability Assessment
Purpose & Capability
The skill's name/description (search 1688 suppliers via AlphaShop) matches the implemented behavior: the script builds JWTs from ALPHASHOP_ACCESS_KEY/ALPHASHOP_SECRET_KEY and calls AlphaShop endpoints. However the registry metadata incorrectly lists no required env vars / no primary credential while both SKILL.md and scripts/search.py require two AlphaShop credentials. This is an incoherence in manifest packaging.
Instruction Scope
SKILL.md instructs the agent and user to provide AlphaShop keys, to call the AlphaShop search and detail endpoints, and to only add filters when asked. The runtime code follows those instructions: it detects input type, optionally calls a detail API to extract title/image, then calls the ai.select.provider.search API and locally filters results. It does not attempt to read arbitrary local files or other env vars. It will send user-supplied URLs (including image URLs) to the external AlphaShop API as part of normal operation.
Install Mechanism
No automated install steps are defined (no install spec). The repository includes a Python script and a requirements.txt listing common libraries (requests, PyJWT) — nothing is downloaded from untrusted hosts and there are no extract-from-URL steps. Running the code requires installing standard Python packages.
Credentials
The code and SKILL.md require two secrets: ALPHASHOP_ACCESS_KEY and ALPHASHOP_SECRET_KEY (used to generate a JWT). Those credentials are proportional to the stated purpose. The concern is that the registry metadata incorrectly declares 'none' required, so the platform-level manifest doesn't surface that the skill needs secret keys. Also the publisher/owner is unknown and there is no homepage, so users must trust the skill's use of their AlphaShop credentials.
Persistence & Privilege
The skill does not request elevated persistence: always is false, there is no install script writing to global configs, and it does not alter other skills. It runs on demand and performs outbound API calls as expected.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install search-1688-supplier - After installation, invoke the skill by name or use
/search-1688-supplier - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.4
Initial release of "search-1688-supplier":
- Enables 1688 supplier search via AlphaShop API using product links, image URLs, or text keywords.
- Supports filtering by maximum price, MOQ, and minimum 48-hour ship rate (applied only if the user explicitly requests).
- Requires mandatory configuration of AlphaShop API keys before use; prompts user if missing.
- Implements precise matching, filter, and display rules with JSON output containing one best match and detailed feedback if no results.
- Provides clear error handling and user guidance for API credit issues and no-match scenarios.
- Includes step-by-step usage instructions and strict output formatting/display guidelines.
Metadata
Frequently Asked Questions
What is search-1688-supplier?
通过 AlphaShop API 搜索和筛选1688供应商。支持三种输入方式: 1688商品链接(查找特定商品的供应商)、图片URL(以图搜货)、 文字关键词(按关键词搜索供应商)。支持按最高价格、最大起批量、 最低48H发货率进行筛选。适用于查找1688供应商、搜索工厂、 以图找商、找供应商、搜商家等场景。 It is an AI Agent Skill for Claude Code / OpenClaw, with 111 downloads so far.
How do I install search-1688-supplier?
Run "/install search-1688-supplier" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is search-1688-supplier free?
Yes, search-1688-supplier is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does search-1688-supplier support?
search-1688-supplier is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created search-1688-supplier?
It is built and maintained by 1688AiInfra (@1688aiinfra); the current version is v1.0.4.
More Skills