Add archived/atomk-to-woocommerce

2026-07-10 16:10:40 +08:00
parent e04866cec5
commit d1750b62ea
1 changed files with 171 additions and 0 deletions
@@ -0,0 +1,171 @@
+---
+name: atomk-to-woocommerce
+category: cross-border-ecommerce
+description: Claim products from AtomK, generate AI listing data, and publish them to WooCommerce via REST API.
+---
+
+# AtomK → WooCommerce Product Publishing
+
+Automates the full pipeline: log into AtomK, claim products from the Product Pool, generate AI listing data, and publish them to an existing WooCommerce store via its REST API.
+
+## Prerequisites
+
+- Node.js Playwright at `/home/ubuntu/.hermes/hermes-agent/node_modules/playwright`
+- `sharp` npm package installed for image resizing
+- Python with `requests` and `Pillow` packages
+- AtomK credentials: admincao / Tt123456!
+- An existing WooCommerce instance (e.g. `us1.atomk.cn`)
+
+## Step 1: Claim Products from AtomK & Generate AI Data
+
+Use the `atomk-bulk-claim` skill approach. Key points for this workflow:
+
+```bash
+export NODE_PATH=/home/ubuntu/.hermes/hermes-agent/node_modules
+node /path/to/atomk_claim_script.js
+```
+
+Script essentials:
+- Login at `https://atomlisting.com/login` (press Enter on password field, do NOT click login button)
+- Navigate to `https://atomlisting.com/products`
+- Select category via `select` element (e.g. `家居百货`)
+- Click `认领并编辑` buttons
+- For each claimed product (URL contains `/editor/{id}`):
+  - Click a platform tab (速卖通 / Temu / 亚马逊 / TikTok Shop / etc.)
+  - Click `AI 生成` and poll until text no longer contains `生成中`
+  - Extract: title, description, price, keywords, image URLs, weight/dimensions
+- Save results to JSON (e.g. `/tmp/atomk_claimed_products.json`)
+
+## Step 2: Prepare WooCommerce API Access
+
+### Discover the WooCommerce instance
+
+Check for existing containers:
+```bash
+sudo docker ps --filter name=wordpress
+```
+
+Check Caddyfile for domain:
+```bash
+sudo docker exec <caddy_container> cat /etc/caddy/Caddyfile
+```
+
+Verify the store:
+```bash
+curl -s -L https://<domain>/wp-json/ | head -5
+```
+
+### Generate API Keys programmatically
+
+**Critical**: Find the actual admin username first — it may NOT be `admin`.
+
+```bash
+# List WP users
+sudo docker exec <wpcli_container> wp user list --format=csv --fields=user_login,user_email
+
+# Generate WooCommerce API key pair
+sudo docker exec <wpcli_container> wp eval '
+if (function_exists("wc_rand_hash")) {
+  $u = get_user_by("login","admincao");   # <-- use actual username
+  if ($u) {
+    global $wpdb;
+    $ck = "ck_" . wc_rand_hash();
+    $cs = "cs_" . wc_rand_hash();
+    $wpdb->insert($wpdb->prefix . "woocommerce_api_keys", [
+      "user_id" => $u->ID,
+      "description" => "Auto API Key",
+      "permissions" => "read_write",
+      "consumer_key" => wc_api_hash($ck),
+      "consumer_secret" => $cs,
+      "truncated_key" => substr($ck, -7)
+    ]);
+    echo "CONSUMER_KEY:" . $ck . "\nCONSUMER_SECRET:" . $cs . "\n";
+  } else { echo "user not found\n"; }
+} else { echo "wc functions not found\n"; }
+'
+```
+
+## Step 3: Publish to WooCommerce
+
+### Python publisher script
+
+```python
+import json, os, requests
+from io import BytesIO
+from PIL import Image
+
+WC_URL = "https://us1.atomk.cn/wp-json/wc/v3"
+CK = "ck_..."
+CS = "cs_..."
+
+def resize_image(data):
+    img = Image.open(BytesIO(data)).convert("RGB")
+    img = img.resize((800, 800), Image.LANCZOS)
+    out = BytesIO()
+    img.save(out, format="JPEG", quality=90)
+    out.seek(0)
+    return out.read()
+
+def create_product(data, image_url):
+    url = f"{WC_URL}/products"
+    payload = {
+        "name": data.get("title", data.get("productCode")),
+        "type": "simple",
+        "regular_price": data.get("price", "10.00"),
+        "description": data.get("description", ""),
+        "short_description": data.get("keywords", ""),
+        "images": [{"src": image_url}],
+        "manage_stock": False,
+        "stock_status": "instock",
+        "status": "publish",
+        "tags": [{"name": t.strip()} for t in data.get("keywords", "").split(",") if t.strip()]
+    }
+    r = requests.post(url, auth=(CK, CS), json=payload)
+    if r.status_code in (200, 201):
+        return r.json().get("id"), r.json().get("permalink")
+    else:
+        print(f"Failed: {r.status_code} {r.text[:500]}")
+        return None, None
+
+def main():
+    with open("/tmp/atomk_claimed_products.json") as f:
+        products = json.load(f)
+
+    for p in products:
+        code = p.get("productCode")
+        imgs = p.get("images", [])
+        if not imgs:
+            continue
+        # Download first image
+        r = requests.get(imgs[0], timeout=30)
+        r.raise_for_status()
+        # Resize
+        resized = resize_image(r.content)
+        # Save locally
+        path = f"/tmp/wc_images/{code}_800x800.jpg"
+        os.makedirs("/tmp/wc_images", exist_ok=True)
+        with open(path, "wb") as f:
+            f.write(resized)
+        # Publish (use external image URL; media upload via WP REST often 401 with WC creds)
+        pid, url = create_product(p, imgs[0])
+        print(f"Created {code} -> ID={pid} {url}")
+
+if __name__ == "__main__":
+    main()
+```
+
+## Pitfalls & Lessons Learned
+
+- **WP admin username discovery**: The WooCommerce container on this system uses `admincao` as the WP admin, not `admin`. Always run `wp user list` first.
+- **WP REST media upload 401**: Uploading images via `/wp-json/wp/v2/media` using WooCommerce consumer key/secret often fails with `invalid_username`. The workaround is to pass the external image URL directly in the product `images` array as `{ "src": "https://..." }`; WooCommerce will download and attach it automatically.
+- **Image resizing**: AtomK images may be large or in webp format. Always convert to 800x800 JPEG before referencing, or let WooCommerce handle the external URL and resize server-side.
+- **HTTPS cert**: atomlisting.com has a cert mismatch; `ignoreHTTPSErrors: true` is required at both `chromium.launch()` and `browser.newContext()` levels.
+- **Login trap**: The login form has `method="get"`. Clicking the button submits GET to `login?` and stays on the page. Press Enter on the password field to trigger the correct JS POST handler.
+- **Platform tab order**: In the AtomK editor, click the platform tab FIRST, THEN click `AI 生成`. The button text changes to reflect the selected platform.
+
+## Verification
+
+List published products:
+```bash
+curl -s -u 'CK:CS' 'https://us1.atomk.cn/wp-json/wc/v3/products?per_page=10'
+```