samchen2009/pdd_skills
/SKILL.md
# pdd_skills (Pinduoduo PDDAgent) This skill describes how to use **pdd_skills_cli.py** to open the Pinduoduo app, search, parse products and stores, and **fully collect a store by keyword and output CSV**. ## Architecture - **PDDAgent** extends **MobileAgent** and uses **UIAutomator** (backed by **UIAutomatorAndroid**). - CLI entry: `pdd_skills_cli.py`; see `requirements.txt` for dependencies. ## How to run From the repo root or from the `pdd_skills` directory: ```bash python pdd_skills/p
tools
Updated Apr 13, 2026
$ install --global
skillsauthnpx skillsauth add samchen2009/pdd_skills pdd_skillsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 25, 2026, 12:07 AM1.7s1 file scanned
SKILL.md
pdd_skills (Pinduoduo PDDAgent)
This skill describes how to use pdd_skills_cli.py to open the Pinduoduo app, search, parse products and stores, and fully collect a store by keyword and output CSV.
Architecture
- PDDAgent extends MobileAgent and uses UIAutomator (backed by UIAutomatorAndroid).
- CLI entry:
pdd_skills_cli.py; seerequirements.txtfor dependencies.
How to run
From the repo root or from the pdd_skills directory:
python pdd_skills/pdd_skills_cli.py <command> [args]
# or
python -m pdd_skills.pdd_skills_cli <command> [args]
You can also run the library module (it delegates to the CLI):
python pdd_skills/pdd_skills.py <command> [args]
Commands
| Command | Description |
|---------|-------------|
| open | Open Pinduoduo (optional --stop to stop then start) |
| ensure-search-page | Open Pinduoduo and go to search page (clicks "搜索" if not already there) |
| search KEYWORD | Search inside the app (optional --search-button for button text) |
| dump-products | Parse product list from current page (--limit N, default 10) |
| dump-stores STORE1 [STORE2 ...] -o FILE | Collect multiple stores in sequence and merge into one CSV |
| dump-products-by-list LIST_FILE [-o CSV] | For each row (store, product, price): search store → in-store search product → open detail → share/copy link; output CSV (default *_YYMMDD.csv). List: JSON [{store,product,price}] or text lines store,product,price (price optional). |
dump-store-page full flow (when store keyword is given)
- open: Open Pinduoduo and go to search page (or simulate click to enter if not there).
- search(STORE): Search for the store keyword; result is a product list (not store list).
- Click products one by one to open product detail; each time run dump_product_detail (scroll detail page to get store info); if store name matches target, click "进店" (enter store), otherwise back and try next product.
- After entering store: Scroll to the end (stop when 5 consecutive scrolls yield no new content or when "本店暂无更多商品" appears).
- While scrolling, dump the page repeatedly and keep collecting if not yet done or incomplete.
- Structure the result (store + products, dedup) and optionally output CSV (
--output-csv FILE).
Global options
--device/-d: Device (Android serial orIP:port); omit for auto-detect.--json: Output full JSON (includingok/result); otherwise only printresultorok.
dump-store-page options (full flow)
store: Store keyword (required to run full flow).--output-csv: Path to write the structured CSV.--max-products: Max number of products to click when looking for the target store (default 20).--no-new-limit: Stop after this many scrolls with no new content inside the store (default 5).
Examples
# Open Pinduoduo
python pdd_skills/pdd_skills_cli.py open
# Go to search page
python pdd_skills/pdd_skills_cli.py ensure-search-page
# Search
python pdd_skills/pdd_skills_cli.py search 3CE
# Dump stores
python pdd_skills/dump-stores "3CE" "4DF" -o reports.csv
# Parse products on current page (max 5)
python pdd_skills/pdd_skills_cli.py dump-products --limit 5
Extra helper: unlock phone screen
Use this helper before running app automation when the device is locked.
- Script:
app_skills/unlock_phone_screen.py - Mock reference:
app_skills/mocks/hms4_unlock.xml - Input: 6-digit numeric password
# from repo root
python app_skills/unlock_phone_screen.py --password 123456
# with explicit device
python app_skills/unlock_phone_screen.py --password 123456 --device 192.168.1.8:5555
Troubleshooting: failure screenshots
When store search fails on abnormal pages (for example popup-covered startup page, missing search page, empty result XML), pdd_skills now auto-saves UI screenshots via uiautomator2.
- Screenshot directory:
pdd_skills/tmp/debug_screenshots/ - Log marker:
debug_screenshot: problem=..., file=..., path=... - Typical problem values:
ensure_search_page_failedsearch_result_no_xmlstore_search_not_found
Quick workflow:
- Search logs for
debug_screenshot. - Open the printed screenshot
path. - Correlate with nearby
pdd_storelogs (search_store, popup close attempts, retries).
Dependencies
See requirements.txt (includes mobile_agent, uiautomator_android, etc.).
Related Skills
openclaw/taskflow
tools
VerifiedTrustedCommunity
Use when work should span one or more detached tasks but still behave like one job with a single owner context. TaskFlow is the durable flow substrate under authoring layers like Lobster, ACPX, plugins, or plain code. Keep conditional logic in the caller; use TaskFlow for flow identity, child-task linkage, waiting state, revision-checked mutations, and user-facing emergence.
357,764SKILL.mdUpdated Apr 10, 2026
openclaw/extensions/lobster
tools
VerifiedTrustedCommunity
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
357,764SKILL.mdUpdated Apr 10, 2026
steipete/extensions/lobster
tools
VerifiedTrustedCommunity
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
357,588SKILL.mdUpdated Apr 13, 2026
steipete/xurl
tools
VerifiedTrustedCommunity
A CLI tool for making authenticated requests to the X (Twitter) API. Use this skill when you need to post tweets, reply, quote, search, read posts, manage followers, send DMs, upload media, or interact with any X API v2 endpoint.
356,423SKILL.mdUpdated Apr 13, 2026