Add cross-border-ecommerce/tongtool-workflows

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)