---
name: tongtool-temu-y2-cheapest-scraper
skill_name: tongtool-temu-y2-cheapest-scraper
category: cross-border-ecommerce
description: >
  全流程自动化：登录Tongtool（通途）ERP → 筛选产品 → 抓取TEMU Y2 cheapest价格数据 → 添加订单备注。
  适用于从通途ERP批量采集TEMU最低价并同步记录订单备注信息。
tags: [tongtool, temu, y2, scraping, e-commerce, price-monitoring, 通途, 订单备注]
---

# 通途 ERP → TEMU Y2 cheapest 抓取 + 订单备注流程

## 前置条件
- 通途账号：`ozonezsjgw@163.com`（Cookie 已保存，通常可自动登录）
- 通途 Cookie 文件：`/home/ubuntu/.hermes/cookies/tongtool_cookies.json`
- 工具：Playwright（Node.js）或 DrissionPage
- 页面特征：通途ERP TEMU → Y2版本 → cheapest列、订单详情页备注框

## 步骤 1：登录通途 ERP

### 1.1 加载 Cookie 免密登录（推荐）
```python
import json
from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(headless=True)
    context = browser.new_context(ignore_https_errors=True)
    
    # 加载已保存的 Cookie
    with open('/home/ubuntu/.hermes/cookies/tongtool_cookies.json', 'r') as f:
        cookies = json.load(f)
    context.add_cookies(cookies)
    
    page = context.new_page()
    page.goto("https://erp.tongtool.com")
    # Cookie有效则自动进入工作台；若失效则走账号密码重登
```

### 1.2 账号密码登录（备用）
- 账号：`ozonezsjgw@163.com`
- 密码：根据实际凭证
- 注意：通途可能有滑动验证码，参照 `captcha-auto-login` skill

## 步骤 2：导航至 TEMU Y2 页面

### 2.1 进入 TEMU 模块
```python
page.click('text=TEMU 半托管')  # 或对应菜单文字
page.wait_for_load_state('networkidle')
```

### 2.2 切换到 Y2 视图
```python
page.click('text=Y2')           # 页面上的 Y2 标签/按钮
page.wait_for_timeout(1000)
```

### 2.3 确认页面定位成功
```python
assert page.locator('text=Y2 cheapest, nth=0').is_visible() or \
       page.locator('th:has-text("Y2 cheapest")').count() > 0
```

## 步骤 3：筛选目标产品

常用筛选条件：
- 品类/类目
- 店铺
- 价格区间
- 上架状态

```python
# 示例：展开筛选面板并设置条件
page.click('button:has-text("筛选")')
page.select_option('select[name="category"]', '家居百货')   # 根据实际控件调整
page.click('button:has-text("查询")')
page.wait_for_timeout(1500)
```

等待列表加载：
```python
page.wait_for_selector('table tbody tr')
```

## 步骤 4：抓取 Y2 cheapest 数据

### 4.1 定位 Y2 cheapest 列
- 表头关键词：`Y2 cheapest`
- 值特征：数字，可能带 `$` 或 `USD` 前缀，颜色可能标识低价优势

### 4.2 单页抓取
```python
import json

data = []
rows = page.query_selector_all('table tbody tr')

for row in rows:
    cells = row.query_selector_all('td')
    product_name = cells[1].inner_text().strip() if len(cells) > 1 else ""
    y2_cheapest = cells[-2].inner_text().strip().replace('$', '').replace(',', '') if len(cells) > 2 else ""
    
    data.append({
        "product_name": product_name,
        "y2_cheapest": float(y2_cheapest) if y2_cheapest else None
    })

with open('temu_y2_cheapest.json', 'w', encoding='utf-8') as f:
    json.dump(data, f, ensure_ascii=False, indent=2)
```

### 4.3 分页抓取
```python
while True:
    scrape_page()
    next_btn = page.query_selector('button.next:enabled, a:has-text("下一页"):not(.disabled)')
    if not next_btn or "disabled" in (next_btn.get_attribute('class') or ''):
        break
    next_btn.click()
    page.wait_for_timeout(2000)
```

## 步骤 5：添加订单备注

在抓取 Y2 cheapest 后，为对应订单添加备注以便后续运营跟踪。

### 5.1 打开订单详情页
列表页中点击目标订单的「订单号」或「详情」按钮：
```python
# 点击第一行的"查看详情"或订单号链接（假设操作列在末尾）
first_row = page.query_selector('table tbody tr')
detail_btn = first_row.query_selector('a:has-text("详情"), button:has-text("详情")')
if detail_btn:
    detail_btn.click()
    page.wait_for_timeout(1500)
```

### 5.2 打开备注/留言输入区域
备注入口通常位于：
- 订单详情页的 **"订单备注"** 标签页
- 右下角弹出的备注图标
- 页面底部的备注输入框

```python
# 方法 A：点击备注标签
remark_tab = page.locator('.el-tabs__item:has-text("订单备注"), text=订单备注')
if remark_tab.count() > 0:
    remark_tab.click()
    page.wait_for_timeout(500)

# 方法 B：直接定位备注文本域
remark_box = page.locator('textarea[placeholder*="备注"], textarea[placeholder*="留言"], .remark-input')
```

### 5.3 填写并保存备注
```python
remark_text = f"Y2 cheapest 采集价: ${price_val} — 采集时间: {datetime.now().strftime('%Y-%m-%d %H:%M')}"

# 填入备注框
page.fill('textarea[placeholder*="备注"]', remark_text)

# 点击保存/提交
page.click('button:has-text("保存备注"), button:has-text("提交"), button:has-text("确定")')
page.wait_for_timeout(800)

# 可选：等待保存成功提示
page.wait_for_selector('.el-notification:has-text("成功"), .el-message:has-text("保存成功")')
```

### 5.4 快捷：列表页批量添加备注（如支持）
部分版本支持在列表行内直接展开备注：
```python
# 点击备注图标展开编辑
remark_icon = row.query_selector('i.icon-remark, span:has-text("备注")')
if remark_icon:
    remark_icon.click()
    page.wait_for_timeout(300)
    page.fill('.inline-remark-input', remark_text)
    page.press('.inline-remark-input', 'Enter')
```

### 5.5 批量备注完整示例
结合抓取与备注：
```python
from datetime import datetime

rows = page.query_selector_all('table tbody tr')
for idx, row in enumerate(rows):
    cells = row.query_selector_all('td')
    if len(cells) < 3:
        continue
    
    order_no = cells[0].inner_text().strip()      # 订单编号
    y2_price = cells[-2].inner_text().strip().replace('$', '')
    
    remark = f"TEMU Y2 cheapest: {y2_price} | 采集: {datetime.now().strftime('%Y-%m-%d')}"
    
    # 进入详情写备注
    detail = row.query_selector('a:has-text("详情")')
    if detail:
        detail.click()
        page.wait_for_timeout(1000)
        
        page.fill('textarea[placeholder*="备注"]', remark)
        page.click('button:has-text("保存")')
        page.wait_for_timeout(500)
        
        # 返回列表
        page.click('button:has-text("返回"), .back-btn')
        page.wait_for_timeout(500)
```

## 步骤 6（可选）：导出 CSV
```python
import csv

with open('temu_y2_cheapest.csv', 'w', newline='', encoding='utf-8-sig') as f:
    writer = csv.DictWriter(f, fieldnames=["product_name", "y2_cheapest"])
    writer.writeheader()
    writer.writerows(data)
```

## 常见问题与排查

| 问题 | 原因 | 解决 |
|------|------|------|
| Cookie 登录失效 | Cookie过期或被注销 | 需重新手动登录并导出Cookie |
| 页面无 Y2 标签 | 账号权限或菜单结构不同 | 确认通途账号有TEMU Y2权限 |
| Y2 cheapest 列值空 | 数据未加载或 lazily rendered | 滚动页面或等 `networkidle` 再抓 |
| 备注保存失败 | 输入框未聚焦或页面未正确渲染 | 先 `click()` 再 `fill()` 备注框 |
| 抓取频率受限 | 触发风控 | 增加随机延时 `random.uniform(2,5)` |

## 相关技能
- `tongtool-erp-automation` — 通途ERP通用自动化
- `tongtool-temu-shipping-calc` — 通途TEMU运费计算
- `captcha-auto-login` — 验证码自动识别登录
- `node-playwright-web-automation` — Node.js Playwright 自动化指南

## 安全提示
- Cookie 文件含敏感凭证，勿上传公开仓库
- 建议对 `tongtool_cookies.json` 设置 `chmod 600`
- 遵守通途平台服务条款，避免高频自动化导致封号