Use this skill when managing a tractor/farm-machinery export business website. Covers: product listing creation, image optimization, SEO for international markets, search engine submission, and site maintenance workflows.
Scanned 9/12/2026
Install to Claude Code
Skills Directorynpx -y skills add clowlove/Hermes-House --skill foreign-trade-operations --agent claude-codeInstalls into .claude/skills of the current project.
Are you the author of Foreign Trade Operations?
Add the live security badge to your README — it updates automatically with every re-scan.
[](https://www.skillsdirectory.com/skills/clowlove-foreign-trade-operations)More formats (shields.io, HTML) on the badges page.
---
name: foreign-trade-operations
description: >-
Use this skill when managing a tractor/farm-machinery export business website.
Covers: product listing creation, image optimization, SEO for international
markets, search engine submission, and site maintenance workflows.
triggers:
- "发布新产品"
- "更新图片"
- "SEO 优化"
- "提交搜索引擎"
- "外贸网站运营"
- "tractor export"
---
# Foreign Trade Operations
## Website Overview
| Site | Platform | Domain | Canonical | Notes |
|------|----------|--------|----------|-------|
| 主站 | GitHub Pages + Cloudflare | shengtuo-tractor.com | → farm-implement.com | 已重定向 |
| 产品站 | GitHub Pages + Cloudflare | farm-implement.com | ✅ self | 主站，SEO 所有指向这里 |
| SADIN站 | GitHub Pages + Cloudflare | sadin-tractor.com | → farm-implement.com | 内容重复，通过 canonical 避免问题 |
| AIV站 | 本地服务器 + Cloudflare | aiv.qzz.io | ✅ self | 源码在 `/home/ubuntu/wwwroot/` |
**2026-05-18 SEO 优化完成:**
- farm-implement.com: canonical/sitemap/OG/JSON-LD 全部指向正式域名 ✅
- sadin-tractor.com: 通过 canonical 指向 farm-implement.com 避免重复内容
- aiv.qzz.io: 独立优化，添加完整 OGP/JSON-LD，源码本地
⚠️ **Cloudflare 覆盖 robots.txt**：Cloudflare Dashboard 的 Rules 可以覆盖源站 robots.txt。更新后不生效请检查 Cloudflare 设置。
**代码库：** `githubtalk/shengtuo-tractor`
### 重要：SEO canonical 指向
- **farm-implement.com** — 主站，所有 canonical/OG/sitemap 指向这里
- **sadin-tractor.com** — 内容相同，通过 canonical 避免重复内容问题
- **aiv.qzz.io** — 独立站，有自己的源码和 sitemap
> ⚠️ **GitHub Pages 部署需要 ~5分钟**，不是 1-2 分钟。推送后不能立即验证。
### 源文件路径
| 站点 | 源文件位置 | 部署方式 |
|------|-----------|----------|
| farm/sadin | `/tmp/shengtuo-tractor/` (git clone) 或 `/home/ubuntu/shengtuo-tractor/` | GitHub Pages |
| aiv.qzz.io | `/home/ubuntu/wwwroot/` | FTP上传到 Windows 主机 |
---
## Product Listing Workflow
### 1. 准备产品图片
图片规范（参考 `compress-images.js`）：
```bash
# 压缩所有图片（已配置）
node compress-images.js
# 手动压缩单张（可选）
# - JPG: quality 75-80, progressive
# - PNG: compressionLevel 9
# - 最大尺寸: 1200x800px
# - 产品图建议: 800x600px
```
**命名规范：** `产品型号-角度-序号.jpg`
例：`ST904-侧面-1.jpg`、`MF904-正面-2.jpg`
### 2. 添加产品页面
产品页面存放路径：`/products/` 目录
每个产品页面需包含：
- 产品型号、名称（英文）
- 主要参数表格（发动机、功率、工作效率）
- 产品图片（带 alt 英文描述）
- PDF规格书下载链接（如有）
- 询盘按钮链接（mailto 或表单）
### 3. 更新 sitemap
生成 sitemap 后确保：
- 所有产品页面链接正确
- `lastmod` 更新为当天日期
- `priority` 按重要性：首页 1.0，产品列表 0.8，单品 0.6
---
## Image Optimization Script
路径：`/home/ubuntu/shengtuo-tractor/compress-images.js`
**用法：**
```bash
cd /home/ubuntu/shengtuo-tractor
node compress-images.js
```
**输出：** 报告压缩文件数 + 节省空间
---
## SEO Checklist
### 每次发布新产品后必做
- [ ] 产品标题含核心关键词（英文）
- [ ] 产品描述含长尾关键词（至少 3 处自然出现）
- [ ] 图片有 alt 英文描述
- [ ] sitemap 更新并提交
- [ ] Google Search Console 提交 URL
- [ ] Bing Webmaster 提交 URL
- [ ] Yandex Webmaster 提交 URL（如面向俄语市场）
- [ ] Baidu Webmaster 提交 URL（如面向中国市场）
### Meta Tags（各平台验证）
| 平台 | Tag | 位置 |
|------|-----|------|
| Google | `coJuNSF-ATVY_yxIm1lR6a4DphP3zTWYrzKABqat_Wg` | index.html |
| Baidu | `codeva-NbRNAmGaEy` (shengtuo-tractor.com) | index.html |
| Baidu | `codeva-1ecpfnMFSE` (farm-implement.com) | index.html |
| Yandex | `3fdba79f71c66d1b` | index.html |
---
## Search Engine Submission
### Google Search Console
URL: https://search.google.com/search-console
- 提交 sitemap: `https://www.shengtuo-tractor.com/sitemap.xml`
- 检测覆盖率错误
- 查看关键词排名
### Bing Webmaster
URL: https://www.bing.com/webmasters
- 需注册/登录 Microsoft 账户
- 支持扫码验证
### Yandex Webmaster
URL: https://webmaster.yandex.com
- 适合俄语、中亚、欧洲市场
### Baidu Webmaster
URL: https://ziyuan.baidu.com
- 中国市场必备
- 支持 HTML 文件验证或 Meta 标签验证
---
## SEO 优化标准流程（GitHub Pages）
当修改 GitHub Pages 站点时，所有 SEO 相关文件必须同步更新：
### 必须更新的 4 个文件
```bash
cd /home/ubuntu/shengtuo-tractor
# 1. index.html - canonical/OG/JSON-LD/sitemap/robots.txt
sed -i 's|old-domain|new-domain|g' index.html
# 2. categories.html（如有）
sed -i 's|old-domain|new-domain|g' categories.html
# 3. sitemap.xml
# 手动更新 <loc> 标签中的域名
# 4. robots.txt
# 更新 Sitemap 行
```
### GitHub Pages 部署流程
```bash
# 1. 修改文件
git add .
git commit -m "SEO update: canonical/OG/JSON-LD"
# 2. 推送到 GitHub（如有冲突）
git pull --rebase origin master
# 如有冲突：
# - 解决冲突
# - git add .
# - git rebase --skip # 当无法设置 EDITOR 时用 skip
# 3. 推送
git push origin master
# 4. 等待 ~5 分钟生效
# 验证：curl https://raw.githubusercontent.com/USER/REPO/master/robots.txt
```
### AIV 站优化流程（本地服务器）
```bash
# 源文件在 /home/ubuntu/wwwroot/
# nginx root 已配置为 /home/ubuntu/wwwroot
# 修改后直接生效（无需上传）
# 更新包打包（需手动上传到其他服务器时）：
tar -czvf /tmp/aiv_seo_update.tar.gz index.html robots.txt sitemap.xml
```
### 域名绑定状态
- `shengtuo-tractor.com` → Cloudflare DNS，CNAME 指向源站
- `farm-implement.com` → GitHub Pages custom domain
- `sadin-tractor.com` → GitHub Pages custom domain（fork 仓库）
**注意：** GitHub Pages 如使用自定义域名，`Enforce HTTPS` 选项在 GitHub 后台可能不可点击（正常），由 Cloudflare 处理 HTTPS 跳转。
---
## 产品描述模板
英文产品描述结构（用于 SEO）：
```html
<!-- 产品标题 -->
<h1>[型号] Agricultural [产品类型] for Sale</h1>
<!-- 产品描述段落 -->
<p>The [型号] is a high-performance agricultural [产品类型] designed for
[主要应用场景]. Featuring [核心参数], it delivers reliable performance
in [适用地形/作物类型] operations across [目标市场].</p>
<!-- 参数列表 -->
<ul>
<li><strong>Engine:</strong> [发动机型号]</li>
<li><strong>Power:</strong> [功率] HP</li>
<li><strong>Working Width:</strong> [工作宽度]</li>
<li><strong>Application:</strong> [适用场景]</li>
</ul>
<!-- 关键词自然分布 -->
<p>This [产品类型] is ideal for [目标国家/地区] farmers looking for
cost-effective farming equipment. Competitive price, fast delivery,
and [其他卖点].</p>
```
---
## 市场关键词参考
| 市场 | 高频搜索词 |
|------|-----------|
| 东南亚 | tractor price, agricultural tractor, 4WD tractor |
| 非洲 | tractor for sale, farm equipment, affordable tractor |
| 欧洲 | agricultural machinery, farm tractor, CE certified |
| 南美 | tractor agrícola, equipo de granja, tractor económico |
| 中东 | farming equipment, agricultural implements |
---
## 常见问题
### 图片太大会影响加载速度
运行 `node compress-images.js` 批量压缩，建议单图 ≤ 200KB。
### sitemap 更新后搜索引擎没更新收录
手动到各平台 Search Console 提交 URL 或重新提交 sitemap，通常 3-7 天更新。
### Cloudflare HTTPS 525 错误
检查源站是否有有效 SSL 证书。无独立 IP 的共享主机建议使用 Cloudflare **Flexible SSL** 模式。
### Baidu 验证失败
确保验证文件正确上传到服务器根目录，或使用 Meta 标签验证方式（直接添加到 index.html 最优）。
---
## 工具路径速查
| 工具 | 路径 |
|------|------|
| 图片压缩脚本 | `/home/ubuntu/shengtuo-tractor/compress-images.js` |
| sitemap | `/home/ubuntu/shengtuo-tractor/sitemap.xml` |
| 主页 | `/home/ubuntu/shengtuo-tractor/index.html` |
| GitHub 仓库 | https://github.com/githubtalk/shengtuo-tractor |
| Cloudflare | https://dash.cloudflare.com |
---
### 报价单翻译工作流
将盛拓农机报价单（`.docx`）翻译为法语、西班牙语等版本，保持格式不变。
### 盛拓报价单结构（实际文档）
共有 **13个表格**，按马力段分布：
| 表格 | 产品系列 | 马力范围 |
|------|----------|----------|
| Table 0 | TS170-ST200 | 17-20HP |
| Table 1 | ST254Y-ST504Y | 25-50HP |
| Table 2 | ST304-ST504 | 30-50HP |
| Table 3 | ST504D MINI.GARDEN | 50HP |
| Table 4 | ST504-ST704 GARDEN | 50-70HP |
| Table 5 | ST504-ST704 | 50-70HP |
| Table 6 | ST604-ST704 | 60-70HP |
| Table 7 | ST504B-ST1004B | 50-100HP |
| Table 8 | ST904-ST1304 | 90-130HP |
| Table 9 | ST1404-ST1804 | 140-180HP |
| Table 10 | ST2004-ST2104 | 200-210HP |
| Table 11 | ST2204-ST2404 | 220-240HP |
| Table 12 | ST2604 | 260HP |
**段落内容（需翻译）：**
- Paragraph 1: 公司介绍（长段落，包含多句）
- Paragraph 2: "We are looking forward to cooperating with you!"
**不翻译内容：**
- Heading 1: 文档标题（"Shengtuo" Company Profile...）
- Heading 3: "Get in Touch:" / "Follow Us for Updates & Videos:"
- 联系信息段落（人名 Henry、电话、邮箱、地址、社交媒体）
### 扩展技术词汇（英→法）
| 英文 | 法语 |
|------|------|
| 2WD / TWO WHEEL DRIVE | 2RM / DEUX ROUES MOTRICES |
| 4WD / FOUR WHEEL DRIVE | 4RM / QUATRE ROUES MOTRICES |
| Type de roues | Type de roues |
| Empattement | wheel base |
| Garde au sol | Ground Clearance |
| Masse | Structure mass |
| Lest roue avant/arrière | Front/Rear Wheel ballast |
| Marque moteur | Engine Brand |
| Type moteur | Engine Type |
| Carburant | Fuel |
| Gasole | Diesel oil |
| Pneumatique | Tyre |
| Roue avant/arrière | Front/Rear wheel |
| Embrayage mono-disque | Single-stage clutch |
| Direction mécanique | Mechanical steering |
| Direction assistée | Power steering |
| Boîte de vitesses | Transmission box |
| Méthode de transmission | Transmission method |
| Courroie trapézoïdale | V-belt |
| Suspension trois points | Tri-point suspension |
| PDF latérale / Prise de force | SIDE PTO |
| Type semi-indépendant | Semi-indenendent type |
| Cadre métallique | iron frame |
| Conteneur | container |
| Conteneur 40' | 40' container / 40HQ |
| Tracteur de jardin | Garden tractor |
| Mini tracteur | Mini tractor |
| AVEC CABINE | CABIN ADD |
| CLIMATISATION | A/C |
| PDF AVANT ET SUSPENSION | FRONT PTO AND SUSPENSION |
| ARCEAU | ROPS |
| Toit solaire | Sun canopy |
| INVERSEUR | SHUTTLE SHIFTS |
| Secteur denté | Gear sector |
| REFROIDISSEUR | water cooled |
| Refroidi par eau | water cooled |
| Cylindre unique horizontal | Single cylinder Horizontal |
| Frein sec, disques | Dry brake,discs |
| Type suralimenté | Turbo / Aspiration |
| Jusqu'à l'évent d'échappement | to the exhaust vent |
| Jusqu'au lest avant | to front ballast |
### 段落翻译示例（公司介绍）
**原文：**
> Shandong Shengtuo Heavy Industry Co.,Ltd.(short for Shengtuo) is a high-level agricultural equipment manufacturer. Shengtuo is located in Weifang City Shandong province, with investment amount of one hundred million Yuan, covers an area of 25,000 square meters, The annual production capacity is 15,000 sets of agricultural machines. The main product is tractor of 25hp--260hp. All the tractor models have been in the List of Government subsidies. Shengtuo has marketing network all over the China, and the tractors have been exported to more than 20 countries. Shengtuo, believes in "honesty, innovation, quality and win-win", for us, the responsibility is the most important, and we will never change the first mind to con-centrate on making tractors, to push the modern Mechanized agriculture!
**译文：**
> Shandong Shengtuo Heavy Industry Co., Ltd. (abréviation : Shengtuo) est un fabricant d'équipements agricoles de haut niveau. Shengtuo est situé dans la ville de Weifang, province du Shandong, avec un investissement de cent millions de yuans, couvrant une superficie de 25 000 mètres carrés. La capacité de production annuelle est de 15 000 ensembles de machines agricoles. Le produit principal est le tracteur de 25 à 260 ch. Tous les modèles de tracteurs sont inscrits sur la liste des subventions gouvernementales. Shengtuo dispose d'un réseau commercial dans toute la Chine, et les tracteurs ont été exportés vers plus de 20 pays. Shengtuo croit en « honnêteté, innovation, qualité et gain partagé » ; pour nous, la responsabilité est la plus importante, et nous ne changerons jamais notre engagement à nous concentrer sur la fabrication de tracteurs, pour promouvoir l'agriculture mécanisée moderne !
### Python 环境注意
**关键发现：** Hermes Agent 的 venv 在 `/home/ubuntu/.hermes/hermes-agent/venv/bin/python3` 没有 python-docx。系统 Python 在 `/usr/bin/python3` 有（通过 pip install --user 安装）。
**运行翻译脚本必须用：**
```bash
/usr/bin/python3 /path/to/translate_script.py
```
不要用 `hermes-agent` 的 venv Python，会报 `ModuleNotFoundError: No module named 'docx'`。
### 翻译脚本模板
```python
#!/usr/bin/env python3
"""Translate document to target language"""
from docx import Document
TRANSLATIONS = {
# 原文: 译文
"Original English text": "Translated text",
}
def translate_text(text):
if not text:
return text
for eng, fr in TRANSLATIONS.items():
if eng in text:
text = text.replace(eng, fr)
return text
def process_document(input_path, output_path):
doc = Document(input_path)
for para in doc.paragraphs:
# Skip headers
if para.style and 'Heading' in para.style.name:
continue
original = para.text
if original.strip():
translated = translate_text(original)
if translated != original:
for run in para.runs:
run.text = ""
para.runs[0].text = translated if para.runs else translated
for table in doc.tables:
for row in table.rows:
for cell in row.cells:
for para in cell.paragraphs:
if para.style and 'Heading' in para.style.name:
continue
original = para.text.strip()
if original:
translated = translate_text(original)
if translated != original:
for run in para.runs:
run.text = ""
para.runs[0].text = translated if para.runs else translated
doc.save(output_path)
if __name__ == "__main__":
import sys
input_file = sys.argv[1]
output_file = sys.argv[2]
process_document(input_file, output_file)
```
**运行：**
```bash
/usr/bin/python3 translate_doc.py input.docx output.docx
```
### 关键原则
1. **参数标签翻译**：Horsepower → Puissance，但数值和单位保留
2. **型号名称不翻译**：TS904、ST504D 等保持原样
3. **价格不翻译**：US$、FOB QINGDAO 保留
4. **技术规格不翻译**：发动机品牌、型号、轮胎规格等
5. **人名/联系信息不翻译**：Henry、电话、邮箱、地址
6. **页眉不翻译**：Heading 样式跳过
---
## ⚠️ 关键原则：SEO/美化 ≠ 重设计
当用户要求 "SEO优化" 或 "外形美观" 时，**不要替换产品结构**。只做：
- 增强 CSS（hover 效果、阴影、过渡动画）
- 添加/改进结构化数据（Schema.org）
- 添加 hreflang、geo meta 标签
- 更新 sitemap.xml
**不要做：**
- 把产品表格改成卡片布局
- 删除或重组原有内容区块
- 替换整个 HTML 文件
> 用户原话："不要动原来的产品结构" — 这是明确的偏好，必须遵守。
**正确做法：** 用 `patch` 工具对 `index.html` 做局部修改，不要用 `write_file` 整体替换。
---
## 网站全面重设计流程
当用户明确要求全面重设计（不仅仅是 SEO/美化）时，才使用以下流程：
### 设计模式（工业/B2B 网站）
**Hero 区域：**
- 渐变背景（深色到亮色）
- 动画标题 + 打字效果
- 徽章标签（如 "Trusted by 50+ Countries"）
- 统计数字动画（15+ Years, 50+ Countries）
- 双按钮布局（主 CTA + 次 CTA）
**产品展示：**
- 卡片布局替代表格（更美观）
- 产品图片 + 徽章（Popular/Heavy Duty）
- 规格标签（HP, 4WD, Diesel）
- 特性列表（✓ Easy Operation）
- 双按钮（Get Quote + Learn More）
**信任模块：**
- 客户评价卡片（头像 + 引用 + 公司信息）
- Why Choose Us 特性网格
- 认证徽章（CE, ISO）
**联系区域：**
- 左侧联系信息 + 右侧询价表单
- WhatsApp 浮动按钮（右下角）
- 营业时间显示
### SEO 增强模式
**Schema.org 结构化数据（必须包含）：**
```json
{
"@type": "Organization", // 公司信息
"@type": "WebSite", // 网站信息
"@type": "WebPage", // 页面信息
"@type": "BreadcrumbList", // 面包屑导航
"@type": "Product", // 产品信息
"@type": "FAQPage" // 常见问题
}
```
**hreflang 多语言标签：**
```html
<link rel="alternate" hreflang="en" href="https://example.com/">
<link rel="alternate" hreflang="zh" href="https://example.com/zh/">
<link rel="alternate" hreflang="x-default" href="https://example.com/">
```
**Open Graph 增强：**
```html
<meta property="og:locale:alternate" content="zh_CN">
<meta property="og:site_name" content="Brand Name">
```
### GitHub Pages 完全重设计推送
当进行完全重设计时，可能遇到合并冲突。使用 force push：
```bash
# 1. 尝试正常推送
git push origin master
# 2. 如果被拒绝（有冲突），先 rebase
git pull origin master --rebase
# 3. 如果 rebase 有冲突且是完全重设计，abort 并 force push
git rebase --abort
git push origin master --force
```
⚠️ **注意**：Force push 会覆盖远程的所有更改。只在完全重设计时使用。
### 部署验证
```bash
# GitHub Pages 部署需要 ~5 分钟
# 验证方式：
# 1. 直接访问 GitHub raw 文件
curl https://raw.githubusercontent.com/USER/REPO/master/index.html
# 2. 检查 CNAME 文件
cat CNAME # 确认域名正确
# 3. 等待后访问网站
# 注意：可能重定向到自定义域名
```Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.
No comments yet. Be the first to comment!
