diff --git a/skills/cross-border-ecommerce/tongtool-workflows/SKILL.md b/skills/cross-border-ecommerce/tongtool-workflows/SKILL.md new file mode 100644 index 0000000..4d5bd0f --- /dev/null +++ b/skills/cross-border-ecommerce/tongtool-workflows/SKILL.md @@ -0,0 +1,90 @@ +--- +name: tongtool-workflows +description: "Tongtool (通途) ERP automation: login, CAPTCHA handling, TEMU shipping calculation, order remarking, and Y2 cheapest price scraping." +version: 1.0.0 +author: Hermes Agent +license: MIT +metadata: + hermes: + tags: [tongtool, erp, temu, shipping, cross-border, automation, drissionpage] + related_skills: [drissionpage-auto-login] +--- + +# Tongtool (通途) ERP Workflows + +Automation workflows for Tongtool ERP — login, CAPTCHA solving, TEMU semi-managed order processing, shipping calculation, and order remarking. + +## Workflow Overview + +| Workflow | Purpose | Automation Tool | +|----------|---------|-----------------| +| **ERP Login** | Automated login with CAPTCHA solving | DrissionPage + ddddocr | +| **TEMU Shipping Calc** | Batch calculate lowest shipping for TEMU orders | Playwright + UI | +| **Y2 Cheapest Price** | Scrape TEMU Y2 lowest price, add remarks | DrissionPage | +| **Order Remark** | Add specific remark to an order | DrissionPage | + +## Section 1: ERP Login & Navigation + +Automated login to Tongtool with CAPTCHA solving via ddddocr. Navigates tabs, handles iframes and popups. + +**When to use:** Starting any Tongtool workflow that requires authentication. + +**Key patterns:** +- DrissionPage ChromiumPage for browser control +- ddddocr for image CAPTCHA recognition +- iframe navigation for embedded content +- Tab switching via `ele.click()` + waiting + +**See:** `references/tongtool-erp-automation.md` for full login flow, CAPTCHA retry, and navigation patterns. + +## Section 2: TEMU Shipping Calculation + +Batch process TEMU semi-managed orders — filter pre-print orders, calculate cheapest shipping price via 仓储物流 → 邮寄方式解析 → TEMU平台接口试算, and write remarks. + +**When to use:** Processing TEMU semi-managed orders to find cheapest shipping option. + +**Key patterns:** +- Playwright for UI automation +- Filter orders without existing remarks +- Iterate through order list +- Parse shipping price from试算 results +- Write price remark (or error remark on failure) +- Support scheduled looping for continuous processing + +**See:** `references/tongtool-temu-shipping-calc.md` for full workflow. + +## Section 3: Y2 Cheapest Price Scraping + +Login to Tongtool, filter products, scrape TEMU Y2 cheapest price data, and add order remarks. + +**When to use:** Need to collect TEMU lowest prices from Tongtool and sync order remarks. + +**Key patterns:** +- DrissionPage for navigation +- Product filtering and iteration +- Price extraction from TEMU data +- Batch remark writing + +**See:** `references/tongtool-temu-y2-cheapest-scraper.md` for full workflow. + +## Section 4: Single Order Remark + +Log into Tongtool, search for a specific order by ID, and add a remark. + +**When to use:** Adding a specific remark to a single known order. + +**Key patterns:** +- Search by order ID +- Navigate to order detail +- Add text remark +- Verify remark saved + +**See:** `references/tongtool-order-remark.md` for step-by-step. + +## Common Pitfalls + +1. **CAPTCHA failure** — retry up to 3 times before giving up; ddddocr accuracy varies +2. **iframe loading** — always wait for iframe content before interacting +3. **Tab switching** — use explicit waits after clicks +4. **Session timeout** — re-login if page shows login form unexpectedly +5. **Printed/shipped orders** — skip these in batch processing (check order status first)