{"id":"66b66aa1-4c64-44a2-b765-65d52244b33f","entityType":"agent","slug":"clawhub-g305595965-cn-ecommerce-ops","name":"国内电商全链路运营","canonicalUrl":"https://www.xpersona.co/agent/clawhub-g305595965-cn-ecommerce-ops","canonicalPath":"/agent/clawhub-g305595965-cn-ecommerce-ops","generatedAt":"2026-10-12T12:11:27.927Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T21:19:54.239Z","emptyReason":null},"description":"国内电商全链路运营专家技能，覆盖淘宝、天猫、京东、拼多多、抖音电商、小红书、视频号、Temu八大平台。提供选品评分、定价与利润测算（含达人佣金）、广告投放ROI测算、店铺转化漏斗诊断、广告法违禁词合规检查、商品标题生成、备货与资金占用测算七个可计算工具，以及一个实时数据桥接器(live.py)——先用 WebSearch/WebFetch 拉取当前真实佣金率、类目退货率、1688进货价、关键词搜索量，再一键灌入各计算器，实现\"实时可用\"的决策。当用户涉及国内电商选品、定价、算利润、算ROI、投直通车或千川、做店铺诊断、写商品标题、算备货量、优化标题主图详情页、写商品文案、直播运营、检查文案是否违反广告法、Temu全托管半托管报价与合规、平台规则与流量玩法，或需要查最新费率/获取实时行情来辅助决策时，应使用本技能。 Skill: 国内电商全链路运营 Owner: g305595965 Summary: 国内电商全链路运营专家技能，覆盖淘宝、天猫、京东、拼多多、抖音电商、小红书、视频号、Temu八大平台。提供选品评分、定价与利润测算（含达人佣金）、广告投放ROI测算、店铺转化漏斗诊断、广告法违禁词合规检查、商品标题生成、备货与资金占用测算七个可计算工具，以及一个实时数据桥接器(live.py)——先用 WebSearch/WebFetch 拉取当前真实佣金率、类目退货率、1688进货价、关键词搜索量，再一键灌入各计算器，实现\"实时可用\"的决策。当用户涉及国内电商选品、定价、算利润、算ROI、投直通车或千川、做店铺诊断、写商品标题、算备货量、优化标题主图详情页、写商品文案、直播运营、检查文案是否违反广告法、Temu全托管半托管报价与合规、平台规则与流量玩法，或需要查最新费率/获取实时行情来辅助决策时，应使用本技能。 Tags: ROI:1.0.","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 991 downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s176zd6q3wdbcwq9tayw8zk86s8c5psb:cn-ecommerce-ops","sourceUrl":"https://clawhub.ai/g305595965/cn-ecommerce-ops","homepage":"https://clawhub.ai/g305595965/skills/cn-ecommerce-ops","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/g305595965/cn-ecommerce-ops","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/g305595965/skills/cn-ecommerce-ops","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"国内电商全链路运营专家技能，覆盖淘宝、天猫、京东、拼多多、抖音电商、小红书、视频号、Temu八大平台。提供选品评分、定价与利润测算（含达人佣金）、广告投放ROI测算、店铺转化漏斗诊断、广告法违禁词合规检查、商品标题生成、备货与资金占用测算七个可计算工具，以及一个实时数据桥接器(live.py)——先用 WebSearc"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T21:19:54.239Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T21:19:54.239Z","emptyReason":null},"stars":null,"forks":null,"downloads":991,"likes":null,"task":null,"library":null,"packageName":null,"latestVersion":"1.2.1","tractionLabel":"991 downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T21:19:54.228Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T21:19:54.239Z","lastCrawledAt":"2026-10-11T21:19:54.228Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T21:19:54.228Z","lastVerifiedAt":null,"highlights":[{"version":"1.2.1","createdAt":"2026-09-07T03:54:32.126Z","changelog":"v1.2.1: 补齐显示名与检索主题词（元数据修订，功能同 v1.2.0）","fileCount":22,"zipByteSize":2791380},{"version":"1.2.0","createdAt":"2026-09-07T03:27:08.940Z","changelog":"v1.2.0: new title_gen.py & inventory.py tools, daren commission in pricing, Temu crossborder reference, compliance dict 216 entries, 48 tests passed","fileCount":22,"zipByteSize":2791223},{"version":"1.0.2","createdAt":"2026-08-15T09:15:16.345Z","changelog":"**重大更新：引入实时数据支持与脚本结构优化** - 增加了 live.py 实时数据桥接脚本，实现从公开数据源获取类目佣金率、退货率、进货价和关键词搜索量，一键灌入各计算器，实现运营决策“实时可用”。 - 改进脚本结构，拆分脚本目录，增加 shared 数据模块（platform_fees.py），提升可维护性和数据一致性。 - README.md、SKILL.md 等文档全面更新，增加实时数据桥接、工作流 E、严明数据链路和入参合理性约束。 - 新增 examples、assets、references、tests 等目录和示例数据，支持自检与快速上手。 - skill-card.md 删除，统一文档入口和结构。","fileCount":26,"zipByteSize":2775867},{"version":"1.0.1","createdAt":"2026-08-09T18:00:36.777Z","changelog":"fix: 补充 topics 标签提升 ClawHub 搜索可见性；上一版 --tags 被当作版本别名未生效","fileCount":17,"zipByteSize":2763055},{"version":"1.0.0","createdAt":"2026-08-09T13:37:24.966Z","changelog":"Initial release: 国内电商选品/定价/利润/ROI/漏斗诊断/广告法合规确定性工具包","fileCount":17,"zipByteSize":2763688}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s176zd6q3wdbcwq9tayw8zk86s8c5psb:cn-ecommerce-ops","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-g305595965-cn-ecommerce-ops/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-g305595965-cn-ecommerce-ops/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-g305595965-cn-ecommerce-ops/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-g305595965-cn-ecommerce-ops/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-g305595965-cn-ecommerce-ops/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-g305595965-cn-ecommerce-ops/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-12T12:11:27.920Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-g305595965-cn-ecommerce-ops/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-g305595965-cn-ecommerce-ops/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-g305595965-cn-ecommerce-ops/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-g305595965-cn-ecommerce-ops/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T21:19:54.239Z","emptyReason":null},"readme":"Skill: 国内电商全链路运营\n\nOwner: g305595965\n\nSummary: 国内电商全链路运营专家技能，覆盖淘宝、天猫、京东、拼多多、抖音电商、小红书、视频号、Temu八大平台。提供选品评分、定价与利润测算（含达人佣金）、广告投放ROI测算、店铺转化漏斗诊断、广告法违禁词合规检查、商品标题生成、备货与资金占用测算七个可计算工具，以及一个实时数据桥接器(live.py)——先用 WebSearch/WebFetch 拉取当前真实佣金率、类目退货率、1688进货价、关键词搜索量，再一键灌入各计算器，实现\"实时可用\"的决策。当用户涉及国内电商选品、定价、算利润、算ROI、投直通车或千川、做店铺诊断、写商品标题、算备货量、优化标题主图详情页、写商品文案、直播运营、检查文案是否违反广告法、Temu全托管半托管报价与合规、平台规则与流量玩法，或需要查最新费率/获取实时行情来辅助决策时，应使用本技能。\n\nTags: ROI:1.0.0, latest:1.2.1\n\nVersion history:\n\nv1.2.1 | 2026-09-07T03:54:32.126Z | user\n\nv1.2.1: 补齐显示名与检索主题词（元数据修订，功能同 v1.2.0）\n\nv1.2.0 | 2026-09-07T03:27:08.940Z | user\n\nv1.2.0: new title_gen.py & inventory.py tools, daren commission in pricing, Temu crossborder reference, compliance dict 216 entries, 48 tests passed\n\nv1.0.2 | 2026-08-15T09:15:16.345Z | auto\n\n**重大更新：引入实时数据支持与脚本结构优化**\n\n- 增加了 live.py 实时数据桥接脚本，实现从公开数据源获取类目佣金率、退货率、进货价和关键词搜索量，一键灌入各计算器，实现运营决策“实时可用”。\n- 改进脚本结构，拆分脚本目录，增加 shared 数据模块（platform_fees.py），提升可维护性和数据一致性。\n- README.md、SKILL.md 等文档全面更新，增加实时数据桥接、工作流 E、严明数据链路和入参合理性约束。\n- 新增 examples、assets、references、tests 等目录和示例数据，支持自检与快速上手。\n- skill-card.md 删除，统一文档入口和结构。\n\nv1.0.1 | 2026-08-09T18:00:36.777Z | user\n\nfix: 补充 topics 标签提升 ClawHub 搜索可见性；上一版 --tags 被当作版本别名未生效\n\nv1.0.0 | 2026-08-09T13:37:24.966Z | user\n\nInitial release: 国内电商选品/定价/利润/ROI/漏斗诊断/广告法合规确定性工具包\n\nArchive index:\n\nArchive v1.2.1: 22 files, 2791380 bytes\n\nFiles: assets/demo.gif (2923122b), examples/realtime_demo_保温杯_douyin.json (807b), LICENSE (1067b), README.md (11186b), references/crossborder-temu.md (4864b), references/listing-and-content.md (7524b), references/operations-playbook.md (7991b), references/platform-playbook.md (9588b), references/product-selection.md (6444b), scripts/ad_calc.py (11720b), scripts/compliance.py (16361b), scripts/diagnose.py (12096b), scripts/inventory.py (10932b), scripts/live.py (22848b), scripts/platform_fees.py (5199b), scripts/pricing.py (15155b), scripts/product_score.py (13926b), scripts/title_gen.py (12111b), skill-card.md (2460b), SKILL.md (17181b), tests/run_all.py (14664b), _meta.json (135b)\n\nFile v1.2.1:SKILL.md\n\n---\nname: cn-ecommerce-ops\nversion: 1.2.1\ndescription: 国内电商全链路运营专家技能，覆盖淘宝、天猫、京东、拼多多、抖音电商、小红书、视频号、Temu八大平台。提供选品评分、定价与利润测算（含达人佣金）、广告投放ROI测算、店铺转化漏斗诊断、广告法违禁词合规检查、商品标题生成、备货与资金占用测算七个可计算工具，以及一个实时数据桥接器(live.py)——先用 WebSearch/WebFetch 拉取当前真实佣金率、类目退货率、1688进货价、关键词搜索量，再一键灌入各计算器，实现\"实时可用\"的决策。当用户涉及国内电商选品、定价、算利润、算ROI、投直通车或千川、做店铺诊断、写商品标题、算备货量、优化标题主图详情页、写商品文案、直播运营、检查文案是否违反广告法、Temu全托管半托管报价与合规、平台规则与流量玩法，或需要查最新费率/获取实时行情来辅助决策时，应使用本技能。\nauthor: g305595965\nrepository: https://github.com/g305595965/cn-ecommerce-ops\nlicense: MIT\ntags:\n  - 电商\n  - 国内电商\n  - 淘宝\n  - 天猫\n  - 京东\n  - 拼多多\n  - 抖音电商\n  - 小红书\n  - 视频号\n  - 选品\n  - 定价\n  - 利润\n  - ROI\n  - 广告投放\n  - 漏斗诊断\n  - 广告法\n  - 合规\n  - Temu\n  - 跨境电商\n  - 标题生成\n  - 备货\ntriggers:\n  - 国内电商\n  - 电商运营\n  - 定价测算\n  - 利润计算\n  - 保本价\n  - 广告ROI\n  - 投放ROI\n  - 转化漏斗\n  - 漏斗诊断\n  - 选品评分\n  - 广告法违禁词\n  - 极限词检查\n  - 淘宝运营\n  - 抖音电商\n  - 小红书运营\n  - 实时费率\n  - 实时行情\n  - 查最新佣金\n  - 1688进货价\n  - 关键词搜索量\n  - 数据以实时为准\n  - Temu\n  - 全托管\n  - 半托管\n  - 跨境电商\n  - 标题怎么写\n  - 商品标题\n  - 备货量\n  - 补货点\n  - 库存测算\n  - 达人佣金\nagent_created: true\n---\n\n# 国内电商全链路运营\n\n## 概述\n\n本技能把国内电商运营中最依赖经验判断的环节，转化为可计算、可复核的\n决策流程。核心主张是：**先算账，再做事**。\n\n多数电商决策失误源于三件事——不算真实利润（漏算退货与推广成本）、\n不算保本 ROI（盲目投放）、不查合规（广告法罚则起点二十万元）。\n本技能为这三件事各提供了确定性工具。\n\n## 何时使用\n\n在遇到以下任一场景时使用本技能：\n\n- 判断某款产品值不值得做（选品评估、竞品分析）\n- 定价、核算真实利润、计算保本售价\n- 投放前测算保本 ROI、可承受最高出价、目标 ROI 反推\n- 店铺流量正常但不出单、转化率下滑、ROI 做不上去\n- 撰写或审核商品标题、主图文案、详情页、短视频脚本、直播话术\n- 检查文案是否触碰广告法违禁词与极限词\n- 了解淘宝/天猫/京东/拼多多/抖音/小红书的流量机制与冷启动打法\n- 制定日常运营节奏、大促排期、备货计划\n\n## 快速路由\n\n根据用户问题类型，选择对应工具或文档：\n\n| 用户问题类型 | 使用 |\n|------------|------|\n| 这个品能不能做 | `scripts/product_score.py` + `references/product-selection.md` |\n| 卖多少钱／能赚多少／保本价／达人佣金怎么算 | `scripts/pricing.py` |\n| 广告怎么投／ROI 多少才不亏／出价多少 | `scripts/ad_calc.py` |\n| 有流量不出单／哪个环节有问题 | `scripts/diagnose.py` |\n| 文案能不能这么写／会不会违规 | `scripts/compliance.py` |\n| 标题怎么写／批量出标题候选 | `scripts/title_gen.py` + `references/listing-and-content.md` |\n| 备多少货／会不会断货／压多少资金 | `scripts/inventory.py` |\n| 给我实时费率/进货价/搜索量再算 | `scripts/live.py`（先 `sources`/`schema` 拉数据，再 `plan` 灌入计算器） |\n| 平台怎么起量／算法逻辑 | `references/platform-playbook.md` |\n| 标题主图详情页／短视频／直播 | `references/listing-and-content.md` |\n| 日常怎么做／大促怎么排／怎么防违规 | `references/operations-playbook.md` |\n| Temu 全托管半托管／跨境报价与合规 | `references/crossborder-temu.md` |\n\n## 可执行工具\n\n全部脚本使用 Python 3 标准库，无第三方依赖，可直接运行。\n所有脚本均支持 `--json` 输出结构化结果，支持 `--self-test` 自检。\n运行前先切换到 `scripts/` 目录，或确保该目录在 `PYTHONPATH` 中。\n\n### 1. 定价与利润测算 —— pricing.py\n\n采用 100 单基准法核算，把退货造成的去程运费、包材、损耗全部计入，\n这是\"卖爆了却在亏钱\"的根本原因。\n\n```bash\npython scripts/pricing.py --cost 35 --price 129 --platform douyin \\\n    --shipping 4.5 --packaging 1.5 --return-rate 30 --ad-ratio 18\n```\n\n输出单均净利、净利率、毛利率、**保本售价**、**保本 ROI** 与成本结构。\n`--list-platforms` 查看内置平台费率参考表（含 Temu）。\n抖音/快手/视频号带货场景用 `--daren-ratio` 计入达人/分销佣金\n（按有效成交额计，退款单佣金退回）。\n\n**关键用法**：在任何定价、报价、谈达人佣金、参加活动前先跑一次。\n得到的\"保本售价\"是价格底线，\"保本 ROI\"是投放的生死线。\n\n### 2. 投放测算 —— ad_calc.py\n\n适用于直通车、万相台、巨量千川、京准通、多多推广等所有 CPC 场景。\n\n```bash\npython scripts/ad_calc.py --price 129 --gross-margin 60 --cvr 2.5 --cpc 1.2 \\\n    --budget 2000 --target-roi 4\n```\n\n输出 UV 价值、当前 ROI、保本 ROI、**可承受最高 CPC**、CPA、\n日预算测算，以及达成目标 ROI 所需的 CPC 或转化率（二选一路径）。\n\n**核心恒等式**：`ROI = UV价值 ÷ CPC`，`保本ROI = 1 ÷ 毛利率`。\n毛利率参数应使用 `pricing.py` 算出的毛利率，两个工具串联使用。\n\n### 3. 转化漏斗诊断 —— diagnose.py\n\n不看哪个数字低，而是看**哪个环节相对行业基准差得最多**，\n偏离最大的环节即为瓶颈，优先修复它的投入产出比最高。\n\n```bash\npython scripts/diagnose.py --impression 200000 --click 2000 --cart 200 \\\n    --order 110 --paid 55 --refund 8 --gmv 6600\n```\n\n输出各环节转化率与基准对比、瓶颈定位、按优先级排序的处方，\n以及\"瓶颈修复到基准后订单能涨多少\"的提升模拟。\n\n**使用原则**：转化链路存在短板时加预算等于放大亏损，先诊断再投放。\n\n### 4. 选品六维评分 —— product_score.py\n\n利润空间 25%、市场需求 20%、竞争强度 20%、退货风险 15%、\n物流成本 10%、供应链 10%，加权总分 100。\n\n```bash\npython scripts/product_score.py --gross-margin 62 --search-index 8000 \\\n    --trend up --supply-ratio 3.2 --return-rate 18 --weight 0.4 \\\n    --moq 100 --restock-days 10\n```\n\n输出总分、各维度得分、短板识别与改进方向。\n阈值：≥75 优质款，60–74 可做款小批量测试，<60 建议放弃。\n\n### 5. 合规检查 —— compliance.py\n\n内置 216 条广告法违禁词库，分三级风险：\nP0 明令禁止（绝对化用语，命中即违法）、P1 需要资质、P2 真实性约束。\n\n```bash\npython scripts/compliance.py --text \"全网最低价，销量第一\"\npython scripts/compliance.py --file detail.txt --min-level P0\n```\n\n输出命中词、风险级别、原文上下文与整改建议。\n**命中 P0 时进程返回码为 1**，可用于批处理或 CI 流程拦截。\n\n**强制要求**：所有对外文案（标题、主图文字、详情页、短视频脚本、\n直播话术、客服话术）发布前必须扫描，P0 必须清零。\n\n### 6. 标题生成 —— title_gen.py\n\n按「核心词 + 属性词 + 场景词」结构公式批量拼装候选标题，\n受平台字数上限硬约束（超长自动从尾部截断、核心词必保留），\n每条候选自动过 compliance 词库预检——**命中 P0 的候选直接剔除**，\nP1/P2 仅标注提醒。\n\n```bash\npython scripts/title_gen.py --core \"汽车LED大灯\" \\\n    --attrs \"激光,双铜管,IP68,H7\" --scenes \"货车,夜行\" --platform pdd --n 5\n```\n\n输出按「核心词位置 + 长度利用率 + 关键词覆盖」打分排序的候选列表。\n字数上限为公开参考值（淘宝/拼多多/抖音 60 字符、京东 50、小红书 40），\n可用 `--limit` 覆盖，发布前以商家后台实际提示为准。\n\n### 7. 备货与资金占用测算 —— inventory.py\n\n把\"备多少货、会不会断货、压多少资金\"量化：\n补货点 ROP = 日均销量 ×（供货周期 + 安全天数），\n建议补货量按 MOQ 向上取整，资金占用 = 补货量 × 单件成本。\n\n```bash\npython scripts/inventory.py --daily-sales 50 --lead-days 7 \\\n    --stock 200 --cost 18 --moq 100 --budget 8000\n```\n\n输出补货点、可售天数、建议补货量、资金占用、断货风险三级分级、\n滞销预警（在库可售 >90 天）与预算约束下的最大可备量。\n适用于自采囤货与 Temu 半托管海外仓场景；一件代发无需备货。\n\n### 8. 实时数据桥接 —— live.py（让前述工具\"实时可用\"）\n\n前面七个工具再准，也依赖**真实入参**：你填的佣金率、退货率、进货价、搜索量，\n若靠拍脑袋就会失真。本脚本把\"先用 WebSearch/WebFetch 拉当前真实值，\n再一键灌入计算器\"标准化，解决\"估算即翻车\"的根因。\n\n```bash\n# 1) 看某平台该去哪拉实时数据（佣金率/退货率/进货价/搜索量）\npython scripts/live.py sources --platform douyin\n\n# 2) 看 live_data.json 该收集哪些字段、单位是什么\npython scripts/live.py schema\n\n# 3) 把拉到的实时值写入 live_data.json 后，生成可直接执行的命令\npython scripts/live.py plan --in live_data.json\n```\n\n`live.py` 自身不抓电商站点（规避反爬与 JS 渲染），而是：\n- `sources` 给出每个平台**官方公示页 / 公开指数工具**的权威 URL，由 Agent\n  用 WebFetch 拉取当前真实佣金率、类目退货率、1688 进货价、关键词搜索量；\n- `plan` 按\"先 pricing 算毛利率 → 再 product_score/ad_calc 串联\"的顺序，\n  生成 pricing / product_score / ad_calc / diagnose 四段命令，并标注缺失字段；\n- `stamp` 输出当前日期，报告自动带上\"数据截至 YYYY-MM-DD\"水印，\n  始终提醒以商家后台为准；\n- `fetch fx` 演示本机直连实时公开接口（汇率，跨境成本换算用），\n  网络受限时优雅降级并提示改用 Agent 侧 WebFetch。\n\n**关键约束**：`live_data.json` 里的 `gross_margin` 必须由 `pricing` 输出，\n`plan` 会强制要求先跑 pricing，保证各工具的数据链路自洽（见 L2 测试）。\n\n### 共享数据模块 —— platform_fees.py\n\n`scripts/platform_fees.py` 是上述工具的**共享费率/基准表**（八大平台佣金率、\n支付费率、行业转化基准），被 pricing / diagnose / product_score 共同 import。\n可直接查看或校准：\n\n```bash\npython scripts/platform_fees.py        # 打印平台费率参考表\n```\n\n表内为公开参考区间，平台政策持续变化，使用前请以商家后台最新公示为准；\n任何数值都可用各脚本的 `--commission` 等参数手动覆盖。\n\n## 知识库\n\n需要方法论、平台规则或实操细节时，按需读取以下文档：\n\n- **`references/platform-playbook.md`** —— 六大国内平台流量机制对比、\n  淘宝搜索权重与坑产逻辑、拼多多价格力与活动起量、抖音赛马机制与 GPM、\n  京东与小红书打法、跨平台通用铁律。\n- **`references/product-selection.md`** —— 选品四道门槛（合规/利润/\n  需求/竞争）、评分模型说明、分品类退货率参考、四种产品角色矩阵、\n  供应链评估与备货公式、六大选品陷阱。\n- **`references/listing-and-content.md`** —— 各平台标题字数与结构公式、\n  主图五图法则、详情页九屏黄金结构、短视频脚本框架、直播节奏与货盘、\n  评价运营、发布前检查清单。\n- **`references/operations-playbook.md`** —— GMV 公式拆解、核心指标\n  定义与健康区间、日周月运营节奏、提升客单价六法、大促五阶段节奏、\n  售后与差评处理、平台与法律风控红线、常见问题速查。\n- **`references/crossborder-temu.md`** —— Temu 全托管/半托管/本对本\n  三模式对比、核价逻辑与保本供货价测算、欧美合规红线（欧代/EPR/CE/\n  FCC/CPC）、履约罚则口径、与本技能工具的串联路径。\n\n## 典型工作流\n\n### 工作流 A：评估一个新品能不能做\n\n1. 用 `product_score.py` 做六维评分，得到初步结论\n2. 若 ≥60 分，用 `pricing.py` 精算利润，确认保本售价与毛利率\n3. 用 `ad_calc.py` 代入毛利率，算出保本 ROI 与最高可承受 CPC\n4. 判断该 CPC 在目标类目是否可实现（对比行业平均 CPC）\n5. 读 `references/product-selection.md` 核对合规资质与供应链风险\n6. 输出结论：做 / 不做 / 小批量测试，并给出价格与投放边界\n\n### 工作流 B：店铺有流量但不出单\n\n1. 用 `diagnose.py` 输入完整漏斗数据，定位瓶颈环节\n2. 按输出的处方逐条执行，不要跳过优先级\n3. 若瓶颈在点击率 → 读 `listing-and-content.md` 主图章节\n4. 若瓶颈在转化率 → 读详情页九屏结构与评价运营章节\n5. 若瓶颈在支付率 → 检查运费门槛、优惠券、库存与催付\n6. 修复后重新跑 `diagnose.py` 对比验证\n\n### 工作流 C：投放亏损，ROI 做不上去\n\n1. 用 `pricing.py` 确认真实毛利率（多数人此处高估）\n2. 用 `ad_calc.py` 算保本 ROI，与实际 ROI 对比\n3. 若实际 ROI < 保本 ROI，用 `--target-roi` 反推需要的 CPC 或转化率\n4. 优先级固定为：提转化率 > 降 CPC > 提客单价\n5. 转化率问题回到工作流 B 做漏斗诊断\n\n### 工作流 D：撰写或审核商品文案\n\n1. 用 `title_gen.py` 按平台字数上限批量产出候选标题（P0 候选已自动剔除）\n2. 读 `references/listing-and-content.md` 对应章节获取结构模板\n3. 按平台字数限制与结构公式撰写\n4. 用 `compliance.py` 扫描，P0 必须清零，P1 确认资质，P2 确认可举证\n5. 对照文档末尾的发布前检查清单逐项确认\n\n### 工作流 E：用实时数据决策（推荐默认路径）\n\n当用户的提问绑定到**具体商品 / 关键词 / 平台**时，不要凭记忆填参数，\n走实时链路，让结论\"实时可用\"：\n\n1. 用 `live.py sources --platform <平台>` 拿到该平台的实时数据源 URL\n2. 用 WebSearch / WebFetch 拉取当前真实值：\n   - 类目佣金率（平台资费公示页）\n   - 类目退货率（平台/行业报告）\n   - 1688 实时进货价（搜关键词按销量排序）\n   - 关键词月搜索量 / 趋势（巨量算数、微信指数、百度指数等）\n3. 把数值写入 `live_data.json`\n4. 用 `live.py plan --in live_data.json` 生成执行命令，按序执行\n5. 报告顶部带上\"数据截至 <日期>\"水印，并提示以商家后台校准\n\n### 工作流 F：Temu 报价与备货\n\n1. 读 `references/crossborder-temu.md` 选定模式（全托管/半托管）并核对合规红线\n2. 用 `pricing.py --platform temu` 反推保本供货价：全托管把供货价当售价；\n   半托管把海外仓与尾程成本计入 `--shipping` / `--other`\n3. 用 `inventory.py` 算海外仓备货：头程周期长时提高 `--safety-days`\n4. 用 `title_gen.py --limit 80` 产出英文标题候选（公开口径 80 字符，\n   以后台为准）并人工本地化\n5. 报价、备货量、罚则口径全部以 Temu 卖家中心最新公示复核\n\n## 铁律\n\n1. **先算账，再做事。** 定价、投放、报活动、谈佣金之前，\n   必须先跑 `pricing.py` 和 `ad_calc.py`，没有保本售价与保本 ROI\n   这两个数字就是在盲目决策。\n2. **诊断优先于加预算。** 转化链路有短板时加预算只会放大亏损。\n3. **合规先于增长。** 广告法罚则起点二十万元，一次翻车抵掉全年利润。\n   所有对外文案先过 `compliance.py`。\n4. **不照搬跨平台打法。** 抖音的内容逻辑与淘宝的搜索逻辑完全不同。\n5. **数据以商家后台为准。** 本技能内置的费率、行业基准均为公开参考值，\n   实际决策必须用后台真实数据校准。\n6. **优先用实时数据，不凭记忆填参。** 用户给了具体商品/平台时，\n   先用 `live.py` + WebSearch/WebFetch 拉当前真实费率、退货率、进货价、\n   搜索量，再灌入计算器；记忆值只作缺失时的兜底，并明确标注为估算。\n7. **不编造数据。** 无法确认的数字应明确说明其为估算或参考区间，\n   并提示用户核实来源。\n\n## 免责声明\n\n本技能提供的费率、行业基准、退货率区间等均为公开信息与行业经验值，\n平台规则持续变化，使用前须以各平台官方最新公示为准。\n合规检查结果为风险自查提示，不构成法律意见，\n具体认定以市场监管部门为准。\n\nFile v1.2.1:README.md\n\n# 国内电商全链路运营 Skill（cn-ecommerce-ops）\n\n![使用演示](assets/demo.gif)\n\n一个面向 AI Agent 的**国内电商运营专家技能包**，覆盖淘宝、天猫、京东、\n拼多多、抖音电商、小红书、视频号七大国内平台及 Temu 跨境。\n\n核心主张只有一句：**先算账，再做事。**\n\n多数电商决策失误来自三件事——不算真实利润（漏算退货与推广成本）、\n不算保本 ROI（盲目投放）、不查合规（广告法罚则起点二十万元）。\n本技能为这三件事各提供了一个可执行、可验证的确定性工具。\n\n![tests](https://img.shields.io/badge/tests-48%20passed-brightgreen)\n![python](https://img.shields.io/badge/python-3.9%2B-blue)\n![deps](https://img.shields.io/badge/dependencies-none-lightgrey)\n![license](https://img.shields.io/badge/license-MIT-green)\n![stars](https://img.shields.io/github/stars/g305595965/cn-ecommerce-ops?style=social)\n![forks](https://img.shields.io/github/forks/g305595965/cn-ecommerce-ops?style=social)\n![issues](https://img.shields.io/github/issues/g305595965/cn-ecommerce-ops)\n\n---\n\n## 为什么需要它\n\n大模型对电商的了解通常停留在\"多做内容、优化主图、提升转化率\"这类\n正确但无用的建议。真正的运营决策需要的是**数字**：\n\n- 这个价格到底赚不赚钱？退货率 30% 之后还剩多少？\n- 投放 ROI 做到多少才不亏？最高能出多少钱一个点击？\n- 有流量不出单，问题到底出在哪一环？\n- 这句文案会不会让我被罚二十万？\n\n本技能把这些问题变成可以直接算出答案的命令。\n\n---\n\n## 七个可执行工具 + 实时数据桥接\n\n全部使用 Python 3 标准库实现，**零第三方依赖**，每个脚本都内置自检。\n\n| 脚本 | 作用 | 关键输出 |\n|------|------|---------|\n| `scripts/pricing.py` | 定价与利润测算 | 单均净利、**保本售价**、**保本 ROI**、成本结构 |\n| `scripts/ad_calc.py` | 付费投放测算 | UV 价值、**可承受最高 CPC**、目标 ROI 反推 |\n| `scripts/diagnose.py` | 转化漏斗诊断 | 瓶颈环节定位、优先级处方、提升模拟 |\n| `scripts/product_score.py` | 选品六维评分 | 综合得分、短板识别与改进方向 |\n| `scripts/compliance.py` | 广告法合规检查 | 216 条违禁词库，三级风险分级与整改建议 |\n| `scripts/title_gen.py` | **商品标题生成** | 按平台字数上限批量产出候选，P0 违禁词自动剔除 |\n| `scripts/inventory.py` | **备货与资金占用测算** | 补货点 ROP、建议补货量、资金占用、断货/滞销风险 |\n| `scripts/live.py` | **实时数据桥接** | 拉取当前真实费率/进货价/搜索量，一键灌入上述计算器 |\n\n> `scripts/platform_fees.py` 是共享数据模块（八大平台佣金率、支付费率、\n> 行业转化基准），被 pricing / diagnose / product_score 共同引用，\n> 可用 `python scripts/platform_fees.py` 直接查看，数值均可用各脚本参数覆盖。\n\n### 让工具\"实时可用\"：live.py\n\n前面七个工具再准，也依赖**真实入参**。与其凭记忆填佣金率、退货率、进货价、\n搜索量，`live.py` 把\"先拉实时数据、再灌入计算器\"标准化：\n\n```bash\n# 看某平台该去哪拉实时数据（官方公示页 / 公开指数工具，无需 API key）\npython scripts/live.py sources --platform douyin\n\n# 看 live_data.json 该收集哪些字段、单位是什么\npython scripts/live.py schema\n\n# 把 WebSearch/WebFetch 拉到的实时值写入 live_data.json，生成执行命令\npython scripts/live.py plan --in live_data.json\n```\n\n`plan` 会按\"先 `pricing` 算毛利率 → 再 `product_score` / `ad_calc` 串联\"的顺序\n生成命令，并标注缺失字段；报告自动带上\"数据截至 YYYY-MM-DD\"水印。\n`live.py fetch fx` 还能本机直连实时汇率接口（跨境成本换算用），网络受限时\n优雅降级并提示改用 Agent 侧 WebFetch。\n\n详见 SKILL.md 的「实时数据路由」与工作流 E。\n\n### 亮点设计\n\n**1. 定价用 100 单基准法，而不是简单减法**\n\n退货产生的去程运费、包材、损耗都不可回收，这是\"卖爆了却在亏钱\"的\n根本原因。脚本模拟发出 100 单、其中 r% 退货，分别核算收入与成本，\n再折算回单均利润。\n\n```bash\npython scripts/pricing.py --cost 35 --price 129 --platform douyin \\\n    --shipping 4.5 --packaging 1.5 --return-rate 30 --ad-ratio 18\n```\n\n**2. 诊断看的是相对基准的偏离度，不是绝对值高低**\n\n哪个环节相对行业基准差得最多，哪个才是真瓶颈，修复它的投入产出比最高。\n\n```bash\npython scripts/diagnose.py --impression 200000 --click 2000 \\\n    --order 110 --paid 55 --gmv 6600\n```\n\n```\n  [!]  点击率         1.00%  基准 2.0~5.0%    偏低 偏离 50.0%\n  [OK] 下单率         5.50%  基准 3.0~8.0%    正常\n  [!]  支付率        50.00%  基准 60.0~85.0%  偏低 偏离 16.7%\n\n--- 瓶颈定位 ---\n  最大瓶颈: 曝光 -> 点击（点击率）\n  可能归因: 主图/短视频首帧、标题、价格带、人群精准度\n```\n\n**3. 合规检查可接入自动化流程**\n\n命中 P0（广告法明令禁止的绝对化用语）时进程返回码为 `1`，\n可直接用于批处理或 CI 拦截。\n\n```bash\npython scripts/compliance.py --file detail.txt --min-level P0\n```\n\n**4. 标题生成即过合规预检**\n\n`title_gen.py` 按「核心词 + 属性词 + 场景词」结构公式拼装候选，\n受平台字数上限硬约束（核心词必保留），每条候选自动过 compliance 词库，\n命中 P0 的直接剔除——产出的标题天然可发布。\n\n```bash\npython scripts/title_gen.py --core \"汽车LED大灯\" \\\n    --attrs \"激光,双铜管,IP68,H7\" --scenes \"货车,夜行\" --platform pdd\n```\n\n**5. 备货决策量化**\n\n`inventory.py` 把补货点、备货量、资金占用算清楚：ROP = 日均销量 ×\n（供货周期 + 安全天数），补货量按 MOQ 取整，断货/滞销双风险分级。\n抖音/快手带货还可用 `pricing.py --daren-ratio 20` 把达人佣金计入利润。\n\n```bash\npython scripts/inventory.py --daily-sales 50 --lead-days 7 \\\n    --stock 200 --cost 18 --moq 100\n```\n\n---\n\n## 五册知识库\n\n| 文档 | 内容 |\n|------|------|\n| `references/platform-playbook.md` | 六大国内平台流量机制对比、淘宝坑产逻辑、拼多多价格力、抖音赛马与 GPM、小红书 CES、冷启动路径 |\n| `references/product-selection.md` | 选品四道门槛、分品类退货率参考、四种产品角色矩阵、供应链评估与备货公式 |\n| `references/listing-and-content.md` | 标题结构公式、主图五图法则、详情页九屏结构、短视频脚本框架、直播节奏与货盘 |\n| `references/operations-playbook.md` | GMV 公式拆解、指标健康区间、日周月节奏、大促五阶段、风控红线速查 |\n| `references/crossborder-temu.md` | Temu 全托管/半托管/本对本对比、核价逻辑、欧美合规红线（欧代/EPR/CE/FCC）、履约罚则口径 |\n\n---\n\n## 安装\n\n### WorkBuddy\n\n```bash\ngit clone https://github.com/g305595965/cn-ecommerce-ops.git ~/.workbuddy/skills/cn-ecommerce-ops\n```\n\n### Claude Code\n\n```bash\ngit clone https://github.com/g305595965/cn-ecommerce-ops.git ~/.claude/skills/cn-ecommerce-ops\n```\n\n### 手动安装\n\n下载仓库 ZIP，解压后将整个目录放入对应的 `skills/` 目录，\n确保目录内直接包含 `SKILL.md`。\n\n安装后重启客户端，向 AI 提问\"帮我算一下这个品能不能做\"即可自动触发。\n\n---\n\n## 直接当命令行工具用\n\n不依赖任何 AI 客户端，脚本本身就是完整的命令行工具：\n\n```bash\ncd scripts\n\n# 查看内置平台费率参考表\npython pricing.py --list-platforms\n\n# 算保本 ROI 和最高出价\npython ad_calc.py --price 129 --gross-margin 60 --cvr 2.5 --cpc 1.2 --target-roi 4\n\n# 选品评分\npython product_score.py --gross-margin 62 --search-index 8000 --trend up \\\n    --supply-ratio 3.2 --return-rate 18 --weight 0.4 --moq 100 --restock-days 10\n\n# 导出完整违禁词库\npython compliance.py --list-rules\n\n# 批量生成合规标题候选\npython title_gen.py --core \"保温杯\" --attrs \"316不锈钢,500ml\" --platform taobao\n\n# 备货与资金占用测算\npython inventory.py --daily-sales 50 --lead-days 7 --stock 200 --cost 18 --moq 100\n```\n\n所有脚本均支持 `--json` 输出结构化结果，方便二次开发与集成。\n\n---\n\n## 测试\n\n```bash\npython tests/run_all.py\n```\n\n三层验证，共 48 项：\n\n- **L1 单元层** —— 逐个运行各脚本内置自检（含公式自洽、单调性、异常拦截）\n- **L2 集成层** —— 验证工具链数据自洽，例如 `pricing.py` 与 `ad_calc.py`\n  两个独立脚本算出的保本 ROI 必须一致、保本售价代回后净利必须归零\n- **L3 结构层** —— 校验 SKILL.md 元数据、文件完整性，\n  以及文档中引用的每一个脚本路径是否真实存在（防止文档说谎）\n\n---\n\n## 数据来源与免责声明\n\n- 内置的平台费率、行业转化基准、分品类退货率均为**公开信息与行业经验值**，\n  文中已逐项标注。平台规则持续变化，实际决策**必须以各平台商家后台\n  最新公示为准**。\n- 合规检查基于《广告法》（2021 修正）第九条等条款及常见执法口径整理，\n  结果为**风险自查提示，不构成法律意见**，具体认定以市场监管部门为准。\n- 部分词汇在特定语境下可合规（如已取得对应批准文号），需结合实际判断。\n\n---\n\n## 贡献\n\n欢迎提 Issue 或 PR，尤其欢迎以下方向：\n\n- 补充或修正平台费率与规则（请附官方来源链接）\n- 扩充违禁词库与整改建议\n- 补充分品类的转化率与退货率基准数据\n- 修正计算模型中的口径问题\n\n提交 PR 前请运行 `python tests/run_all.py` 确保全部通过。\n\n---\n\n## 更新日志\n\n### v1.2.1（2026-09-07）\n\n- 元数据修订：补齐 ClawHub 显示名（国内电商全链路运营）与检索主题词，\n  修复按中文名搜索不到的问题；功能与 v1.2.0 完全一致\n\n### v1.2.0（2026-09-07）\n\n- 新增 `scripts/title_gen.py`：按结构公式批量生成标题候选，\n  平台字数硬约束 + 合规预检，P0 候选自动剔除\n- 新增 `scripts/inventory.py`：补货点 ROP、建议补货量（MOQ 取整）、\n  资金占用、断货三级风险与滞销预警、预算约束反推\n- `pricing.py` 新增 `--daren-ratio`：达人/分销佣金按有效成交额计入，\n  保本售价反解同步支持\n- 新增 Temu 平台：`platform_fees.py` 费率条目、`live.py` 数据源、\n  `references/crossborder-temu.md` 跨境手册（模式对比/核价/合规红线）\n- `compliance.py` 词库扩充至 216 条（新增保健食品功能声称、\n  排他性表述、承诺兑现、产地真实性等类目）\n- 测试三层 48 项全通过\n\n### v1.1.0（2026-08-15）\n\n- 新增实时数据桥接 `live.py`，计算器\"实时可用\"\n- 修复 plan 生成命令的布尔旗标与参数映射 bug\n\n### v1.0.0（2026-08-09）\n\n- 首个版本：五个可执行工具 + 四册知识库\n\n---\n\n## License\n\n[MIT](LICENSE)\n\nFile v1.2.1:_meta.json\n\n{\n  \"ownerId\": \"kn7d4jg6kwefccgm7gdmxkzkv18c4neh\",\n  \"slug\": \"cn-ecommerce-ops\",\n  \"version\": \"1.2.1\",\n  \"publishedAt\": 1788753272126\n}\n\nFile v1.2.1:references/crossborder-temu.md\n\n# Temu 跨境运营手册（全托管 / 半托管 / 本对本）\n\n> 本手册基于 2026 年公开资料与卖家社群口径整理。Temu 规则迭代极快，\n> **所有费率、保证金、时效数字务必以 Temu 卖家中心（seller.kuajingmaihuo.com）\n> 规则中心与招商经理的最新口径为准**。多方来源数字冲突处本文已标注。\n\n## 一、三种模式对比\n\n| 维度 | 全托管 | 半托管 | 本对本 |\n|------|--------|--------|--------|\n| 本质 | 供货模式：你是平台供应商 | 卖家自履约 + 平台流量 | 海外本土店 |\n| 货物位置 | 发 Temu 国内集运仓 | 你的海外仓 / 3PL | 目标国本土仓 |\n| 定价权 | 无（平台核价定价） | 有（系统给参考价，可申诉） | 基本自主 |\n| 保证金 | 约 ¥1,000（可退） | 约 ¥10,000 或 $1,400 | 依站点政策 |\n| 佣金 | 名义 0（差价隐含 2%~5%） | 按类目约 6%~15%（口径不一） | 依站点政策 |\n| 回款周期 | 慢（约 30 天上下） | 快（确认收货 T+1，约 8 天） | 依站点 |\n| 履约时效 | 平台负责 | 严考核（48h 上网率等） | 2~5 天签收 |\n| 适合 | 源头工厂、清库存、测款 | 有海外仓/物流资源的卖家 | 有海外主体的品牌卖家 |\n\n**选型铁律**：无跨境经验先全托管测款，但不要把全托管当长期利润来源——\n定价权为零意味着利润天花板由平台决定。有海外仓能力尽早转半托管。\n\n## 二、核价逻辑（全托管的生死线）\n\n- 全托管报价 = 你愿意接受的最低单件回款。平台核价普遍对标 1688 同款价\n  与全网低价，报价虚高直接被拒或限流。\n- 2026 年《互联网平台价格行为规则》生效后，平台已取消\"强制跟价\"，\n  价格在流量分配中的权重下降，评分/履约/合规权重上升——但低价竞争力\n  仍是入池前提。\n- 报价测算路径：先用 `scripts/pricing.py` 按\"供货价=售价\"反推你的保本\n  供货价（成本+头程分摊+损耗），报价低于此值就是亏本供货。\n- 半托管定价：系统核价有异议可在后台提交成本凭证申诉（公开口径称\n  2 个工作日内处理，以实际为准）。\n\n## 三、合规红线（2026 严查项）\n\n无以下文件，欧美站点直接下架+罚款：\n\n1. **欧代 / 英代 / 美代**：欧盟、英国、美国站点的授权代表（公开行情约\n   ¥500~2000/年，服务商报价差异大）。\n2. **EPR 注册**：包装法、电池法、WEEE 等，按类目与站点（约 ¥300~1500/类目）。\n3. **产品认证**：CE（欧盟）、FCC（美国电子类）、CPC/CPSIA（母婴儿童）、\n   FDA（食品接触/美妆按类目）。\n4. **知识产权**：标题/图片含品牌词、卡通形象、专利外观 = 下架 + 扣罚，\n   严重封店。无品牌散件也要排查外观专利。\n\n汽车配件类（如 LED 车灯）特别注意：涉及车辆安全件的类目在部分站点\n有额外认证要求（如 DOT/E-mark），上架前必须在卖家中心核对类目资质清单。\n\n## 四、履约与罚则（卖家社群口径，以后台罚则页为准）\n\n- 订单履约率要求 ≥95%，入仓质检通过率 ≥90%（社群口径）；断货一次\n  可能导致链接权重清零。\n- 延迟发货、缺货、质检不合格均有梯度罚款；质量事故罚款可达数万元级\n  （社群有个案报道），务必留足质检余量。\n- 半托管 48 小时上网率等时效考核趋严，选择海外仓/尾程服务商时优先\n  看轨迹上网速度而非单纯价格。\n\n## 五、与本技能工具的串联\n\n1. **测款**：`scripts/product_score.py` 评估品类（Temu 偏好轻小件、标品、\n   低客单；重货大件基本被劝退）。\n2. **报价**：`scripts/pricing.py --platform temu`，把供货价当售价算保本线；\n   半托管把海外仓+尾程成本计入 `--shipping` 与 `--other`。\n3. **备货**：海外仓备货用 `scripts/inventory.py` 测算——头程海运 30 天+\n   的供货周期下，安全天数建议 15 天以上（`--safety-days 15`）。\n4. **标题**：英文标题 ≤80 字符（公开口径），用 `scripts/title_gen.py\n   --limit 80` 生成候选后人工本地化。\n5. **实时数据**：`scripts/live.py sources --platform temu` 获取核验入口。\n\n## 六、常见坑速查\n\n- 全托管爆款可能被平台要求转半托管（\"同款绑定\"社群口径），提前评估\n  海外仓能力。\n- 回款周期长，现金流按 45 天以上规划（全托管）。\n- 单日上新有上限（公开口径 400 条/日，与店铺动销挂钩），精铺优于铺货。\n- 保证金从回款中冻结而非预缴（2026 年口径），关店无违规可退。\n\n> 免责声明：以上为公开信息整理，不构成平台官方规则解释；\n> 违规认定与罚则以 Temu 卖家中心公示及协议为准。\n\nFile v1.2.1:references/listing-and-content.md\n\n# 商品呈现与内容创作手册\n\n> 流量进来之后，能否转化全靠这一环。所有对外文案发布前，\n> 必须先经过 `scripts/compliance.py` 合规扫描。\n\n---\n\n## 一、标题优化\n\n### 各平台字数限制\n| 平台 | 上限 | 备注 |\n|------|------|------|\n| 淘宝 / 天猫 | 30 汉字（60 字符） | 用满，不浪费字符 |\n| 京东 | 30 汉字左右 | 品牌词前置 |\n| 拼多多 | 60 字符 | 简洁直白，突出价格力 |\n| 抖音商城 | 30 汉字左右 | 口语化，贴近搜索习惯 |\n| 小红书笔记 | 20 汉字（显示约 20 字） | 前 10 字最关键 |\n\n### 标题结构公式\n```\n营销词 + 品牌词 + 核心词 + 属性词 + 场景词 + 长尾词\n```\n\n**示例**（女士针织衫）：\n```\n2024新款 XX品牌 针织开衫 女 宽松 慵懒风 春秋 外搭 小个子 上衣\n```\n\n### 关键原则\n1. **核心词必须完整可切分** —— 不要把\"针织开衫\"拆成\"针织 时尚 开衫\"，\n   否则搜索引擎无法完整匹配\"针织开衫\"这个词。\n2. **新品用长尾词，成熟品抢大词** —— 新品没有权重，抢大词只会被淹没。\n   先用\"针织开衫女小个子慵懒风\"这类精准长尾词吃转化。\n3. **属性词必须与后台属性一致** —— 不一致会被判定为标题违规或降权。\n4. **不堆砌无关热词** —— 引来不精准流量会打乱人群标签，得不偿失。\n5. **禁用广告法违禁词** —— \"最\"字系、\"第一\"、\"国家级\"等一律不能出现。\n\n### 关键词来源\n- 平台搜索下拉框（真实用户搜索）\n- 竞品标题拆解（取交集高频词）\n- 生意参谋 / 抖音电商罗盘 / 京东商智的搜索词分析\n- 直通车关键词报表（有真实点击数据的词最可靠）\n\n---\n\n## 二、主图设计（决定点击率）\n\n### 五图 + 一视频的标准配置\n| 位置 | 作用 | 要点 |\n|------|------|------|\n| 主图 1 | 抓眼球 | 产品主体清晰 + 一句核心卖点（≤8字） |\n| 主图 2 | 卖点强化 | 最强差异化功能，用对比或数据体现 |\n| 主图 3 | 场景化 | 产品在真实使用场景中的样子 |\n| 主图 4 | 细节特写 | 材质、工艺、做工，建立品质感 |\n| 主图 5 | 信任状 | 资质证书、检测报告、售后承诺 |\n| 主图视频 | 综合展示 | 15–30 秒，前 3 秒必须有信息量 |\n\n### 提升点击率的实操要点\n- **左上角是黄金视觉区**，最重要的信息放这里（符合 F 型视觉动线）\n- 文字**不超过图片面积 20%**（平台规则），且必须大而清晰，\n  手机上缩略图只有指甲盖大小，小字等于没有\n- **色彩要跳出搜索结果页**：竞品都用白底，你用彩底就能跳出来\n- **主图必须 A/B 测试**，用直通车小预算测点击率，\n  跑出高于行业均值的图再放大投放，不要凭审美决定\n\n---\n\n## 三、详情页黄金结构\n\n用户决策路径：**我有什么问题 → 你能解决吗 → 凭什么信你 → 为什么现在买**\n\n| 屏序 | 内容 | 目的 |\n|------|------|------|\n| 第 1 屏 | 核心卖点 + 使用场景大图 | 3 秒内说清\"这是什么、解决什么\" |\n| 第 2 屏 | 痛点场景还原 | 引发共鸣：\"这说的就是我\" |\n| 第 3 屏 | 解决方案 + 核心功能 | 给出答案 |\n| 第 4 屏 | 参数与规格 | 满足理性决策需求 |\n| 第 5 屏 | 细节展示 | 材质、做工、工艺 |\n| 第 6 屏 | 信任背书 | 资质、检测报告、销量、媒体报道 |\n| 第 7 屏 | 用户评价 / 买家秀 | 从众心理，真实感最重要 |\n| 第 8 屏 | 售后保障 | 消除最后顾虑（七天无理由、运费险、质保） |\n| 第 9 屏 | 促销信息 + 行动号召 | 临门一脚，制造合理紧迫感 |\n\n**核心原则**：\n- **前三屏决定 70% 的跳失**，最强的内容必须前置\n- 移动端优先，单张图高度不超过 1200px，避免加载过慢\n- **不要用大段文字**，用图 + 短句，用户是\"扫\"不是\"读\"\n- 促销紧迫感必须**真实**（虚构倒计时构成价格欺诈）\n\n---\n\n## 四、短视频带货脚本框架\n\n### 黄金 3 秒开场（决定生死）\n四种经过验证的开场方式：\n1. **痛点直击** —— \"你是不是也这样...\"\n2. **结果前置** —— 直接展示使用后的效果\n3. **反常识冲突** —— \"千万别再这样做了\"\n4. **身份代入** —— \"小个子女生一定要看\"\n\n### 30–60 秒脚本结构\n```\n0–3s   黄金开场（痛点/结果/冲突）\n3–10s  问题放大（为什么这件事很麻烦）\n10–25s 产品出场 + 核心卖点演示（要看得见的效果）\n25–40s 使用场景 + 效果展示\n40–50s 信任背书（销量/资质/真实反馈）\n50–60s 行动号召 + 利益点（限时优惠、赠品）\n```\n\n### 关键指标与优化方向\n| 指标不达标 | 优化位置 |\n|-----------|---------|\n| 3 秒完播率低 | 开场没抓住人，重做前 3 秒 |\n| 完播率低 | 中段节奏拖沓，删冗余镜头 |\n| 点击率低 | 挂车时机不对，或产品与内容不匹配 |\n| 转化率低 | 落地页承接问题，看详情页与价格 |\n\n---\n\n## 五、直播运营\n\n### 单场直播节奏（15–25 分钟一个循环）\n```\n1. 引流憋单（3–5 分钟）\n   用福利款/秒杀留人，拉停留时长，积累在线人数\n2. 产品讲解（8–12 分钟）\n   痛点 → 卖点 → 演示 → 对比 → 信任状\n3. 逼单成交（3–5 分钟）\n   限时限量、价格锚点、赠品叠加，倒数上链接\n4. 循环往复\n```\n\n### 货盘结构\n- **福利款** —— 引流留人，亏本或平本，控制数量\n- **爆款/主推款** —— 走量核心，占销售额 50% 以上\n- **利润款** —— 赚钱主力\n- **形象款** —— 拉高客单价与直播间调性\n\n### 核心指标诊断\n| 指标 | 说明 | 偏低时的动作 |\n|------|------|------------|\n| 平均停留时长 | 低于 30 秒说明开场有问题 | 改开场话术、加福利钩子 |\n| UV 价值 | 成交额 ÷ 观看人数 | 提高转化或客单价 |\n| 转化率 | 成交人数 ÷ 观看人数 | 优化讲解与逼单话术 |\n| 互动率 | 评论点赞 ÷ 观看 | 增加互动引导与抽奖 |\n\n---\n\n## 六、评价与口碑运营\n\n评价是转化率的**决定性因素之一**，尤其是前 10 条。\n\n### 实操要点\n- **首批评价至关重要**，必须确保真实优质，带图带视频\n- 主动引导评价：包裹卡（不得以好评返现诱导，平台明令禁止）、\n  售后回访、会员积分\n- **差评必须第一时间响应**，公开回复要克制专业，\n  展现解决问题的态度——回复是给后来的潜在买家看的\n- **定期分析差评关键词**，这是产品迭代最真实的输入源\n- 「问大家」板块同样影响转化，需要主动维护\n\n### 合规红线\n- **好评返现属于违规行为**，平台会处罚，且涉嫌违反《反不正当竞争法》\n- **刷单炒信违法**，情节严重可构成犯罪\n- 不得**删除或屏蔽真实差评**\n\n---\n\n## 七、发布前检查清单\n\n每一条对外内容发布前，逐项确认：\n\n- [ ] 已运行 `python scripts/compliance.py --file 文案.txt`，无 P0 命中\n- [ ] 标题字数未超限，核心词完整可切分\n- [ ] 后台属性与标题、详情页描述完全一致\n- [ ] 主图无违规文字占比，无第三方品牌/水印\n- [ ] 价格与优惠券逻辑正确，划线价为真实成交价\n- [ ] 所有宣称的功效/资质均有对应证明文件\n- [ ] 促销时间与库存真实可兑现\n- [ ] 无站外引流信息（小红书、抖音尤其严格）\n\nFile v1.2.1:references/operations-playbook.md\n\n# 日常运营、数据体系与风控手册\n\n---\n\n## 一、GMV 公式拆解：所有运营动作的起点\n\n```\nGMV = 曝光量 × 点击率 × 转化率 × 客单价\n    = 访客数(UV) × 转化率 × 客单价\n    = 访客数 × UV 价值\n```\n\n**任何提升 GMV 的动作，必然落在这四个变量之一上。**\n说不清自己在优化哪个变量的运营动作，都是无效动作。\n\n| 变量 | 提升手段 | 见 |\n|------|---------|-----|\n| 曝光量 | 关键词覆盖、付费投放、活动坑位、内容分发 | platform-playbook.md |\n| 点击率 | 主图、标题、价格带、人群精准度 | listing-and-content.md |\n| 转化率 | 详情页、评价、价格力、信任状、客服 | listing-and-content.md |\n| 客单价 | 套餐搭配、满减凑单、关联推荐、升级款 | 本文第四节 |\n\n**诊断顺序**：先用 `scripts/diagnose.py` 找出最短板的环节，\n再针对性投入。四个变量都及格时，才应该加大流量投入。\n\n---\n\n## 二、核心指标定义与健康区间\n\n### 流量与转化\n| 指标 | 计算方式 | 说明 |\n|------|---------|------|\n| UV | 独立访客数 | 流量规模 |\n| 点击率 CTR | 点击 ÷ 曝光 | 主图与标题的吸引力 |\n| 转化率 CVR | 支付人数 ÷ 访客数 | 承接能力 |\n| UV 价值 | 支付金额 ÷ 访客数 | 单个流量的产值，投放的核心依据 |\n| 客单价 | 支付金额 ÷ 支付人数 | 单笔订单规模 |\n| 加购收藏率 | 加购收藏 ÷ 访客 | 潜在需求，预示后续转化 |\n\n### 投放效率\n| 指标 | 计算方式 | 说明 |\n|------|---------|------|\n| ROI / ROAS | 成交金额 ÷ 广告花费 | 投产比 |\n| 保本 ROI | 1 ÷ 毛利率 | 低于此值必亏，用 `ad_calc.py` 算 |\n| CPC | 花费 ÷ 点击 | 点击单价 |\n| CPA | 花费 ÷ 成交单数 | 获客成本 |\n| GPM | 成交额 ÷ 曝光 × 1000 | 抖音核心指标 |\n\n### 服务与健康度\n| 指标 | 健康区间（经验值） | 影响 |\n|------|-----------------|------|\n| DSR 动态评分 | ≥ 4.8 | 低于均值影响搜索权重 |\n| 退款率 | 低于行业均值 | 超标直接降权 |\n| 退款自主完结时长 | 越短越好 | 影响服务分 |\n| 发货时效 | 24–48 小时内 | 超时罚款且降权 |\n| 客服响应时长 | < 30 秒 | 影响转化与服务分 |\n| 纠纷率 | 越低越好 | 严重时限制活动报名 |\n\n**重要**：各平台的服务分（抖音体验分、拼多多服务分、天猫 DSR）\n直接决定能否报名活动、能否获得流量扶持，是运营的生命线。\n\n---\n\n## 三、运营节奏\n\n### 每日必做（30 分钟）\n1. 看昨日核心数据：GMV、UV、转化率、ROI，与前一日/上周同期对比\n2. 检查异常：流量突降、转化突降、差评、退款激增\n3. 处理待发货订单，确保不超时\n4. 回复所有评价与「问大家」\n5. 检查广告计划消耗与 ROI，暂停明显亏损的计划\n\n### 每周必做\n1. 拉取周数据，做转化漏斗诊断（`diagnose.py`）\n2. 关键词报表分析：加词、删词、调价\n3. 竞品监控：价格、活动、新品、主图变化\n4. 库存盘点，触发补货\n5. 复盘本周投放，输出下周计划\n\n### 每月必做\n1. 全店产品结构复盘：引流/利润/形象/狙击款的贡献占比\n2. 利润核算（`pricing.py` 实算，不看毛估）\n3. 差评关键词聚类，输出产品改进需求\n4. 下月活动排期与备货计划\n\n---\n\n## 四、提升客单价的六种手段\n\n1. **满减凑单** —— 门槛设在客单价的 1.5 倍左右最有效\n2. **套餐组合** —— 主品 + 配件打包，比单卖利润更高\n3. **多规格阶梯定价** —— 买 2 件更划算，直接拉高件单价\n4. **关联推荐** —— 详情页底部与购物车页推荐互补品\n5. **升级款引导** —— 用价格锚点让中间档看起来最划算\n6. **赠品换购** —— 加 X 元换购高感知价值商品\n\n**注意**：提升客单价往往会降低转化率，\n需用 `ad_calc.py` 验证 UV 价值（客单价 × 转化率）是否净提升。\n\n---\n\n## 五、大促节奏（以双 11 / 618 为例）\n\n| 阶段 | 时间 | 核心动作 |\n|------|------|---------|\n| 预热蓄水 | 提前 30–45 天 | 上新、内容种草、拉新加购收藏 |\n| 加购蓄水 | 提前 10–15 天 | 定金预售、优惠券发放、直播预告 |\n| 爆发期 | 大促当日 | 全力投放、直播续场、客服全员待命 |\n| 返场期 | 后 3–7 天 | 承接犹豫用户，清理尾货 |\n| 复盘期 | 后 7–15 天 | 数据复盘、退货处理、库存消化 |\n\n**易踩的坑**：\n- **备货不足**：爆单后断货，权重与口碑双杀\n- **备货过量**：大促后长期库存积压，现金流枯竭\n- **价格穿底**：为冲量把价格打到亏损，大促后无法恢复原价\n- **客服崩盘**：响应超时导致服务分下降，影响后续流量\n- **物流爆仓**：预留发货缓冲，提前与快递协商产能\n\n---\n\n## 六、售后与客服\n\n### 降低退货率的实操手段\n1. **前置预期管理** —— 详情页把尺码、色差、材质说清楚，\n   宁可少卖也不要卖错。预期落差是退货第一原因。\n2. **尺码表要给真实数据** —— 服饰类提供模特身高体重与穿着尺码\n3. **主动售后** —— 发货后主动推送物流，签收后回访\n4. **退货原因分析** —— 每月聚类分析，反推产品与文案问题\n\n### 差评处理原则\n- **第一时间响应**，24 小时内\n- 公开回复是**写给潜在买家看的**，不是写给差评者看的：\n  克制、专业、给出解决方案，不辩解不对骂\n- 私下联系解决实际问题，能挽回则挽回\n- **不得删除或屏蔽真实差评**，也不得骚扰要求修改评价\n\n---\n\n## 七、风控红线（触碰即重罚）\n\n### 平台层面\n| 违规行为 | 后果 |\n|---------|------|\n| 刷单炒信 | 扣分、降权、清退，情节严重构成犯罪 |\n| 虚假发货 | 高额罚款 + 降权 |\n| 延迟发货 | 按单赔付 + 服务分下降 |\n| 售假/侵权 | 商品下架、扣分、店铺关闭、保证金扣除 |\n| 盗用他人图片 | 侵权投诉、删除链接、赔偿 |\n| 描述不符 | 退款率上升 + 平台处罚 |\n| 站外引流 | 小红书/抖音尤其严格，限流至封号 |\n| 好评返现 | 违规且涉嫌违反《反不正当竞争法》 |\n\n### 法律层面\n- **《广告法》第九条** —— 绝对化用语，罚款起点二十万元。\n  所有文案发布前必须过 `scripts/compliance.py`。\n- **《消费者权益保护法》** —— 七天无理由退货义务\n- **《电子商务法》** —— 平台内经营者需公示营业执照、依法纳税\n- **《反不正当竞争法》** —— 禁止虚假宣传、刷单、诋毁竞争对手\n- **《价格法》** —— 禁止虚构原价、虚假优惠折价\n\n### 自查频率建议\n- 每次上新：合规扫描 + 资质核对\n- 每周：抽查在售商品文案\n- 每月：全店文案批量扫描（`compliance.py --file`）\n- 平台规则更新时：立即全店自查\n\n---\n\n## 八、常见问题速查\n\n**Q：流量突然下降怎么办？**\n按顺序排查：① 是否有违规扣分 ② 关键词排名是否掉了\n③ 竞品是否有大动作 ④ 是否是类目大盘下滑（看行业数据）\n⑤ 主图/标题/价格是否被改动 ⑥ 广告计划是否被暂停或预算耗尽。\n\n**Q：有流量没转化？**\n用 `diagnose.py` 定位具体环节。常见原因：流量不精准（人群标签乱了）、\n价格无竞争力、评价有硬伤、详情页说服力不足。\n\n**Q：ROI 一直做不上去？**\n用 `ad_calc.py` 先算保本 ROI。若当前 ROI 低于保本值，\n优先级是：提转化率 > 降 CPC > 提客单价。\n盲目加预算只会放大亏损。\n\n**Q：要不要做低价冲量？**\n先算账。低价冲量会打乱人群标签、拉低客单价心智，\n且平台比价机制会记录历史低价。除非有明确的冲层级/冲活动目标，\n否则不建议。用 `pricing.py` 算出保本售价，绝不低于此价。\n\nFile v1.2.1:references/platform-playbook.md\n\n# 国内六大电商平台流量机制与打法\n\n> 说明：本文为运营实操经验总结。平台算法与规则持续迭代，具体权重口径以\n> 各平台商家后台官方文档、规则中心公示为准。文中标注「经验值」的部分为\n> 行业普遍认知，非平台官方公布数据。\n\n---\n\n## 一、机制差异总览\n\n不同平台的底层逻辑决定了打法完全不同，照搬必死。\n\n| 平台 | 流量本质 | 用户心智 | 决定性指标 | 起量关键 |\n|------|---------|---------|-----------|---------|\n| 淘宝/天猫 | 搜索为主 + 推荐 | 有明确需求，货比三家 | 单坑产出（坑产） | 关键词卡位 + 人群标签 |\n| 京东 | 搜索为主 | 品质与时效优先 | 转化率 + 客单价 | 类目排名 + 物流时效 |\n| 拼多多 | 推荐为主 | 价格敏感，冲动下单 | 价格力 + 销量 | 活动坑位 + 低价冲量 |\n| 抖音 | 内容推荐 | 无明确需求，被激发 | GPM（千次观看成交额） | 内容点击率 + 转化效率 |\n| 小红书 | 内容搜索 + 推荐 | 决策前查攻略 | 笔记互动率 | 关键词种草 + 口碑沉淀 |\n| 视频号/微信小店 | 社交推荐 + 私域 | 信任驱动 | 复购率 | 私域沉淀 + 社交裂变 |\n\n**核心判断**：需求明确的标品去淘宝/京东/拼多多，需求需要被创造的\n非标品、新奇特产品去抖音/小红书。\n\n---\n\n## 二、淘宝 / 天猫\n\n### 搜索排序的权重构成（经验值）\n优先级从高到低：\n\n1. **类目相关性** —— 类目放错，后面全白搭。这是一票否决项。\n2. **文本相关性** —— 标题关键词与搜索词的匹配度\n3. **商品权重** —— 单坑产出（该关键词下的支付金额）、转化率、收藏加购率\n4. **店铺权重** —— 店铺层级、DSR 评分、退款率、纠纷率\n5. **个性化标签** —— 商品人群标签与搜索用户标签的匹配度\n\n**「坑产」是淘宝搜索的核心**：同一个关键词下，谁的支付金额高，谁排前面。\n所以刷低价单破坏的不只是转化率，更是把人群标签打乱。\n\n### 店铺层级\n按近 30 天支付金额分为 7 层。**跨层是流量分水岭**，同层商家互相竞争。\n卡在层级边缘时，冲一把跨层的收益远大于日常优化。\n\n### 标题规范\n- 天猫/淘宝标题上限 **30 个汉字（60 字符）**\n- 结构：`营销词 + 品牌词 + 核心词 + 属性词 + 长尾词`\n- 核心词必须放在能被完整切分的位置，避免关键词被拆散\n- 不留空格可提高字符利用率，但要保证可读性\n- 新品期用**精准长尾词**，有基础销量后再抢大词\n\n### 新品冷启动路径\n1. **0–7 天**：上架后打标（新品标），完善所有属性，主图/详情页做足\n2. **7–14 天**：用精准长尾词做基础销量 5–10 单 + 真实评价 + 买家秀\n3. **14–30 天**：直通车测图测款，跑出点击率高于行业均值的主图\n4. **30 天后**：有数据基础后放大投放，逐步抢中大词\n\n### 付费工具\n- **直通车（标准推广）** —— 关键词竞价，控词控人群，测款测图首选\n- **引力魔方** —— 人群定向，拉新与收割，适合推荐流量\n- **万相台无界** —— 智能化投放，托管出价，适合缺乏投放经验的商家\n\n---\n\n## 三、拼多多\n\n### 核心逻辑\n拼多多是**推荐流量为主**的平台，首页推荐占比远高于搜索。\n用户决策路径极短，价格力是第一位的。\n\n### 权重构成（经验值）\n`销量 + 转化率 + 价格力 + 服务分（DSR/发货时效/纠纷率）`\n\n**价格力**：平台会拿你的商品与全网同款比价，价格无优势直接失去推荐流量。\n\n### 起量路径\n1. 新品上架，先用**低价 + 低毛利**冲基础销量与评价\n2. 报名平台活动坑位：**限时秒杀、9块9特卖、百亿补贴**\n3. 活动带来的爆发销量会反哺自然推荐流量\n4. 有权重后再逐步调价，或用高毛利款承接流量\n\n### 推广工具\n- **搜索推广** —— 关键词竞价，意图明确\n- **场景推广** —— 推荐位竞价，走量核心\n- **明星店铺 / 全站推广** —— 智能投放\n\n**注意**：拼多多对**发货时效与售后**极其严格，延迟发货、虚假发货罚款重，\n\"仅退款\"政策对商家不友好，选品要充分考虑退货与纠纷成本。\n\n---\n\n## 四、抖音电商（兴趣电商）\n\n### 流量机制：赛马制\n内容发布后进入初始流量池（经验值约 300–500 曝光），\n系统根据数据表现决定是否推入下一级流量池。**层层赛马，逐级放大**。\n\n因此**前 500 次曝光的数据表现决定了这条内容的生死**。\n\n### 最核心指标：GPM\n```\nGPM = 成交金额 ÷ 曝光人数 × 1000\n```\n即\"每一千次观看能产生多少成交额\"。抖音判断是否给你更多流量，\n本质就是看你的流量变现效率，GPM 越高，系统越愿意给量。\n\n**提升 GPM 只有三条路**：提高点击率、提高转化率、提高客单价。\n\n### 短视频带货关键指标\n| 指标 | 参考基准（经验值） | 影响 |\n|------|-----------------|------|\n| 3 秒完播率 | > 45% | 决定是否继续推流 |\n| 完播率 | > 15% | 内容质量核心信号 |\n| 点击率（视频→商品） | > 3% | 挂车吸引力 |\n| 转化率 | > 3% | 商品详情承接力 |\n\n**黄金 3 秒**：前 3 秒必须给出冲突、痛点或结果，否则直接划走。\n\n### 直播间核心指标\n- **停留时长** —— 低于 30 秒说明开场话术或货品有问题\n- **互动率** —— 评论、点赞、加粉，影响推流\n- **UV 价值** = 成交额 ÷ 观看人数，直播间的\"坑产\"\n- **转化率** —— 场观到成交\n\n**直播节奏**：憋单引流 → 讲解产品 → 逼单成交 → 循环。\n每个循环 15–25 分钟，福利款引流、利润款赚钱、形象款拉高客单。\n\n### 付费工具：巨量千川\n- **随心推** —— 简易版，适合小额加热内容\n- **专业版-控成本投放** —— 设定成交出价，系统控制 CPA，稳定但量少\n- **专业版-放量投放** —— 不控成本，冲量用，风险高\n- **常见打法**：先用小额测素材，跑出高 CTR 素材后再放大投放\n\n### 达人分销\n通过**精选联盟**挂佣金，招募达人带货。\n佣金率通常设置在 **10%–30%**（另需支付平台技术服务费）。\n高佣金能吸引达人，但要先用 pricing.py 算清楚是否还有利润空间。\n\n---\n\n## 五、京东\n\n### 特点\n- 用户**购买意图明确**，客单价与转化率普遍高于其他平台\n- **物流时效是核心竞争力**，使用京东物流对搜索权重和转化都有正向影响\n- 3C 数码、家电品类优势明显\n\n### POP 店铺权重\n`销量 + 转化率 + 好评率 + 店铺星级（店铺评分）+ 物流时效`\n\n### 推广工具：京准通\n- **快车** —— 关键词竞价，等同直通车\n- **京东直投 / 购物触点** —— 站内展示位\n- **京挑客** —— 达人分销\n\n**注意**：京东有平台使用费和类目扣点，POP 店铺还有保证金要求，\n入驻门槛高于淘宝，但客单价与利润空间通常更好。\n\n---\n\n## 六、小红书\n\n### 平台本质\n**决策前的攻略平台**。用户在这里\"查作业\"，然后可能在小红书买，\n也可能去淘宝/天猫下单。所以小红书的价值不只是 GMV，更是**心智种草**。\n\n### 笔记权重：CES 评分（业内经验公式，官方未公开）\n```\nCES = 点赞×1 + 收藏×1 + 评论×4 + 转发×4 + 关注×8\n```\n**收藏与评论的价值远高于点赞**，因为它们代表\"真实有用\"。\n所以笔记结尾引导收藏（\"先码住\"）比引导点赞更有效。\n\n### 内容策略\n- 标题必须带**核心搜索关键词**，小红书搜索流量占比高\n- 正文自然植入关键词 3–5 次，结尾带 3–5 个精准话题标签\n- 封面图是点击率的决定因素，竖版 3:4，文字信息清晰\n- **真实感 > 精致感**，过度商业化的内容会被限流\n\n### 合规红线\n- 商业笔记必须通过**蒲公英平台**报备，否则会被判违规限流\n- 严禁**站外引流**（留微信、淘口令），轻则限流重则封号\n- 医美、保健品等类目有严格的内容限制\n\n### 变现路径\n1. 笔记种草 → 小红书商城闭环成交\n2. 笔记种草 → 用户去其他平台搜索品牌词下单（需做好品牌词承接）\n3. 买手直播带货\n\n---\n\n## 七、视频号 / 微信小店\n\n### 核心价值\n**社交推荐 + 私域沉淀**。依托微信生态，信任成本低，复购率高。\n\n### 打法\n- 公域：视频号内容推荐、直播广场\n- 私域：社群、朋友圈、公众号导流至小店\n- **社交裂变**：拼团、分享有礼在微信生态天然适配\n\n适合**高复购、需要信任背书**的品类（食品、母婴、健康、知识付费）。\n\n---\n\n## 八、跨平台通用铁律\n\n1. **不要照搬打法**。抖音的爆款视频思路搬到淘宝详情页会水土不服。\n2. **先算账再投流**。任何投放前先用 `pricing.py` 与 `ad_calc.py`\n   算出保本 ROI 与最高可承受 CPC，没有这两个数字就是在盲投。\n3. **人群标签一旦打乱，恢复成本极高**。低价冲量、非目标人群引流\n   会污染标签，导致后续精准流量失效。\n4. **合规先于增长**。所有对外文案先过 `compliance.py`，\n   广告法罚则起点二十万，一次翻车抵掉全年利润。\n5. **数据诊断优先于加预算**。转化链路有短板时加预算等于放大亏损，\n   先用 `diagnose.py` 定位瓶颈。\n\nFile v1.2.1:references/product-selection.md\n\n# 选品方法论与决策框架\n\n> 选品决定了 70% 的结果。运营能力只能放大选品的正确性，无法逆转错误的选品。\n\n---\n\n## 一、选品的四道门槛（顺序不可颠倒）\n\n任何一款产品，必须按顺序通过以下四关，前一关不过直接淘汰，不要留恋。\n\n### 第一关：合规关（一票否决）\n先确认能不能卖，再谈赚不赚钱。\n\n| 品类 | 强制要求 |\n|------|---------|\n| 3C 电子、儿童玩具、电器 | CCC 强制认证 |\n| 食品 | 食品经营许可证、SC 生产许可 |\n| 化妆品 | 化妆品备案凭证；美白/祛斑需「国妆特字」批文 |\n| 保健食品 | 蓝帽子批准文号 |\n| 医疗器械 | 一/二/三类医疗器械经营备案或许可 |\n| 图书音像 | 出版物经营许可证 |\n| 品牌商品 | 品牌授权书（缺失即侵权下架） |\n\n**知识产权排查**：外观专利、实用新型专利、商标、著作权。\n跨境或新奇特产品尤其容易踩专利雷，一封投诉信可能导致全店冻结。\n\n### 第二关：利润关\n用 `scripts/pricing.py` 实算，不要凭感觉。\n\n**判断标准（经验值）**：\n- 毛利率 **< 40%** —— 无法承担付费流量，只能靠自然流量，慎入\n- 毛利率 **40%–60%** —— 可做，但投放空间紧张，需精细化运营\n- 毛利率 **> 60%** —— 有充足投放空间，可以打爆款\n\n**必须算进去但最容易被忽略的成本**：\n去程运费、退货回程运费、包材、平台佣金、支付手续费、\n推广费、客服人力分摊、仓储分摊、坏账与损耗。\n\n### 第三关：需求关\n判断这个东西**到底有没有人要**。\n\n- **搜索型平台（淘宝/京东/拼多多）**：看关键词搜索指数与趋势。\n  搜索量持续下滑的品类不要进，那是在接盘。\n- **推荐型平台（抖音/小红书）**：看话题热度、同类内容互动量。\n  已经有内容跑出爆款说明需求被验证，完全没有内容的要警惕是伪需求。\n- **季节性判断**：提前 45–60 天布局。夏季品五月才上架已经晚了。\n\n### 第四关：竞争关\n```\n供需比 = 关键词搜索人气 ÷ 在售商品数\n```\n供需比越高说明需求大而供给少，机会越大。\n\n**竞争格局判断**：\n- 头部（TOP10）占据 80% 以上份额 → 垄断市场，新手勿入\n- 头部分散，长尾商家有销量 → 有机会切入\n- 全是白牌低价厮杀 → 除非有供应链成本优势，否则不进\n\n---\n\n## 二、选品评分模型\n\n用 `scripts/product_score.py` 量化打分，避免拍脑袋决策。\n六个维度，加权总分 100 分：\n\n| 维度 | 权重 | 评分要点 |\n|------|-----|---------|\n| 利润空间 | 25% | 毛利率高低，是否支撑投放 |\n| 市场需求 | 20% | 搜索量/内容热度及趋势方向 |\n| 竞争强度 | 20% | 供需比、头部集中度 |\n| 退货风险 | 15% | 品类退货率、尺码/色差问题 |\n| 物流成本 | 10% | 重量体积、易碎性、发货难度 |\n| 供应链 | 10% | 起订量、翻单速度、账期 |\n\n**决策阈值（经验值）**：\n- **≥ 75 分** —— 优质款，可重点投入资源打造\n- **60–74 分** —— 可做款，小批量测试后再决定\n- **< 60 分** —— 放弃，机会成本太高\n\n---\n\n## 三、按退货率划分的品类风险\n\n退货率是国内电商最容易被低估的利润杀手，尤其在抖音等冲动消费场景。\n\n| 品类 | 退货率参考区间（经验值） | 主要原因 |\n|------|----------------------|---------|\n| 服饰鞋帽 | 30%–50%（直播可达 60%+） | 尺码、色差、版型预期落差 |\n| 美妆护肤 | 10%–20% | 肤感不符、过敏 |\n| 3C 数码 | 5%–15% | 参数不符、质量问题 |\n| 家居日用 | 10%–20% | 尺寸不符、材质预期 |\n| 食品生鲜 | 5%–15% | 物流损耗、口味 |\n| 图书文具 | 3%–8% | 相对最低 |\n\n**关键**：服饰类在抖音直播场景退货率可能超过 50%，\n用 `pricing.py --return-rate 50` 算一下，很多\"爆单\"其实是巨亏。\n\n---\n\n## 四、产品结构：四种角色缺一不可\n\n单靠一款产品无法支撑店铺，必须搭建产品矩阵。\n\n1. **引流款**（占比 20%）\n   低价高需求，用于获取流量与新客，毛利可接近于零，甚至微亏。\n   考核指标是**引流效率**（UV 成本），不是利润。\n\n2. **利润款**（占比 30%）\n   店铺的现金流来源，毛利率 60% 以上，靠引流款带来的流量承接转化。\n   考核指标是**利润额**。\n\n3. **形象款**（占比 10%）\n   高客单、高品质，拉高店铺整体调性与客单价，销量不高但不可缺。\n   考核指标是**客单价拉升**。\n\n4. **狙击款**（占比 40%）\n   对标竞品的同款或改良款，用于抢占竞品流量，价格与卖点针对性设计。\n   考核指标是**市场份额**。\n\n---\n\n## 五、供应链与备货\n\n### 供应商评估要点\n- **起订量（MOQ）** —— 首单不要压太多货，测款期用小单快反\n- **翻单速度** —— 爆款出现后能否 7 天内补货，这决定能否吃到红利\n- **账期** —— 现结还是月结，直接影响资金周转\n- **质检能力** —— 次品率高会推高退货率，摧毁店铺权重\n- **是否支持一件代发** —— 起步期降低库存风险\n\n### 备货公式\n```\n安全库存 = 日均销量 × 补货周期天数 × (1 + 安全系数)\n建议备货量 = 预估日销 × 备货天数 - 现有库存 - 在途库存\n```\n安全系数一般取 **0.2–0.5**，大促期间取上限。\n\n**备货铁律**：\n- 新品测试期：只备**7–15 天**销量，宁可断货也不要压死资金\n- 稳定期：备**20–30 天**销量\n- 大促前：按预估峰值备货，但要留好尾货处理方案\n- **季节性商品必须在季末前清空**，压到下一年的库存基本等于亏损\n\n---\n\n## 六、常见选品陷阱\n\n1. **自嗨式选品** —— \"我觉得这个好\"。市场数据才是唯一依据。\n2. **只看销量不看利润** —— 卖爆了却在亏钱，是最常见的死法。\n3. **忽略退货率** —— 服饰类尤其致命，退货率算错一切归零。\n4. **忽略专利与授权** —— 尤其是新奇特产品与品牌周边。\n5. **盲目跟风爆款** —— 你看到爆款时，红利期通常已过，\n   且价格战已经开始，此时入场是接盘。\n6. **供应链没谈好就推爆款** —— 推爆了补不上货，权重掉光，得不偿失。\n\nFile v1.2.1:skill-card.md\n\n## Description:\n\n帮助电商经营者在淘宝、天猫、京东、拼多多、抖音电商、小红书、视频号及 Temu 上评估选品、测算定价和投放回报、诊断转化、检查文案并规划备货。\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[g305595965](https://clawhub.ai/user/g305595965)\n\n### License/Terms of Use:\n\nMIT\n\n## Use Case:\n\n电商经营者和运营人员使用该技能评估产品、测算利润与广告回报、定位店铺转化瓶颈，并辅助商品文案审核及库存计划。\n\n### Deployment Geography for Use:\n\nChina, with Temu cross-border selling guidance\n\n## Known Risks and Mitigations:\n\nRisk: Live-data commands can include untrusted values that become executable shell text.\n\nMitigation: Validate and shell-quote every value in live_data.json, and review generated commands before execution.\n\nRisk: Live searches may expose sensitive product, supplier, pricing and platform details to external sites.\n\nMitigation: Avoid sending confidential business terms to external search or fetch services without approval.\n\nRisk: Reference fees and compliance checks can be outdated or incomplete.\n\nMitigation: Confirm rates and rules against current seller-platform notices and obtain human review before publishing claims or making consequential decisions.\n\n## Reference(s):\n\n- [ClawHub skill listing](https://clawhub.ai/g305595965/skills/cn-ecommerce-ops)\n- [Platform operations playbook](artifact/references/platform-playbook.md)\n- [Product selection guide](artifact/references/product-selection.md)\n- [Listing and content guide](artifact/references/listing-and-content.md)\n- [Operations playbook](artifact/references/operations-playbook.md)\n- [Temu cross-border guide](artifact/references/crossborder-temu.md)\n\n## Skill Output:\n\n**Output Type(s):** [Analysis, Guidance, Markdown, Shell commands]\n\n**Output Format:** [Markdown guidance and calculator results, with optional JSON output]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Live-data workflows may suggest commands to run with user-supplied values.]\n\n## Skill Version(s):\n\n1.2.1 (source: ClawHub release evidence and skill frontmatter)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.2.1:examples/realtime_demo_保温杯_douyin.json\n\n{\n  \"meta\": {\n    \"keyword\": \"316不锈钢保温杯(500ml)\",\n    \"platform\": \"douyin\",\n    \"as_of\": \"2026-08-15\",\n    \"note\": \"实时数据来源: 抖音厨具佣金率取自抖店规则中心2026资费标准+九大扶持政策(常规2%-5%,厨具免佣可至0.6%); 进货价取自1688/义乌购316保温杯实时批发页(¥12-15); 退货率取饮具类6.7%-12%中值; 热度/趋势取自1688夏季爆款榜(趋势向上). 搜索量/供需比为估算proxy,请于巨量算数/生意参谋核实.\"\n  },\n  \"cost\": 12.0,\n  \"price\": 49.9,\n  \"commission\": 2.0,\n  \"shipping\": 3.0,\n  \"packaging\": 1.5,\n  \"return_rate\": 10.0,\n  \"ad_ratio\": 18.0,\n  \"search_index\": 120000,\n  \"trend\": \"up\",\n  \"supply_ratio\": 3.0,\n  \"weight_kg\": 0.4,\n  \"fragile\": false,\n  \"moq\": 10,\n  \"restock_days\": 3,\n  \"cvr\": 2.5,\n  \"cpc\": 1.5\n}\n\nFile v1.2.1:LICENSE\n\nMIT License\n\nCopyright (c) 2026 g305595965\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\nArchive v1.2.0: 22 files, 2791223 bytes\n\nFiles: assets/demo.gif (2923122b), examples/realtime_demo_保温杯_douyin.json (807b), LICENSE (1067b), README.md (10984b), references/crossborder-temu.md (4864b), references/listing-and-content.md (7524b), references/operations-playbook.md (7991b), references/platform-playbook.md (9588b), references/product-selection.md (6444b), scripts/ad_calc.py (11720b), scripts/compliance.py (16361b), scripts/diagnose.py (12096b), scripts/inventory.py (10932b), scripts/live.py (22848b), scripts/platform_fees.py (5199b), scripts/pricing.py (15155b), scripts/product_score.py (13926b), scripts/title_gen.py (12111b), skill-card.md (2775b), SKILL.md (17181b), tests/run_all.py (14664b), _meta.json (135b)\n\nFile v1.2.0:SKILL.md\n\n---\nname: cn-ecommerce-ops\nversion: 1.2.0\ndescription: 国内电商全链路运营专家技能，覆盖淘宝、天猫、京东、拼多多、抖音电商、小红书、视频号、Temu八大平台。提供选品评分、定价与利润测算（含达人佣金）、广告投放ROI测算、店铺转化漏斗诊断、广告法违禁词合规检查、商品标题生成、备货与资金占用测算七个可计算工具，以及一个实时数据桥接器(live.py)——先用 WebSearch/WebFetch 拉取当前真实佣金率、类目退货率、1688进货价、关键词搜索量，再一键灌入各计算器，实现\"实时可用\"的决策。当用户涉及国内电商选品、定价、算利润、算ROI、投直通车或千川、做店铺诊断、写商品标题、算备货量、优化标题主图详情页、写商品文案、直播运营、检查文案是否违反广告法、Temu全托管半托管报价与合规、平台规则与流量玩法，或需要查最新费率/获取实时行情来辅助决策时，应使用本技能。\nauthor: g305595965\nrepository: https://github.com/g305595965/cn-ecommerce-ops\nlicense: MIT\ntags:\n  - 电商\n  - 国内电商\n  - 淘宝\n  - 天猫\n  - 京东\n  - 拼多多\n  - 抖音电商\n  - 小红书\n  - 视频号\n  - 选品\n  - 定价\n  - 利润\n  - ROI\n  - 广告投放\n  - 漏斗诊断\n  - 广告法\n  - 合规\n  - Temu\n  - 跨境电商\n  - 标题生成\n  - 备货\ntriggers:\n  - 国内电商\n  - 电商运营\n  - 定价测算\n  - 利润计算\n  - 保本价\n  - 广告ROI\n  - 投放ROI\n  - 转化漏斗\n  - 漏斗诊断\n  - 选品评分\n  - 广告法违禁词\n  - 极限词检查\n  - 淘宝运营\n  - 抖音电商\n  - 小红书运营\n  - 实时费率\n  - 实时行情\n  - 查最新佣金\n  - 1688进货价\n  - 关键词搜索量\n  - 数据以实时为准\n  - Temu\n  - 全托管\n  - 半托管\n  - 跨境电商\n  - 标题怎么写\n  - 商品标题\n  - 备货量\n  - 补货点\n  - 库存测算\n  - 达人佣金\nagent_created: true\n---\n\n# 国内电商全链路运营\n\n## 概述\n\n本技能把国内电商运营中最依赖经验判断的环节，转化为可计算、可复核的\n决策流程。核心主张是：**先算账，再做事**。\n\n多数电商决策失误源于三件事——不算真实利润（漏算退货与推广成本）、\n不算保本 ROI（盲目投放）、不查合规（广告法罚则起点二十万元）。\n本技能为这三件事各提供了确定性工具。\n\n## 何时使用\n\n在遇到以下任一场景时使用本技能：\n\n- 判断某款产品值不值得做（选品评估、竞品分析）\n- 定价、核算真实利润、计算保本售价\n- 投放前测算保本 ROI、可承受最高出价、目标 ROI 反推\n- 店铺流量正常但不出单、转化率下滑、ROI 做不上去\n- 撰写或审核商品标题、主图文案、详情页、短视频脚本、直播话术\n- 检查文案是否触碰广告法违禁词与极限词\n- 了解淘宝/天猫/京东/拼多多/抖音/小红书的流量机制与冷启动打法\n- 制定日常运营节奏、大促排期、备货计划\n\n## 快速路由\n\n根据用户问题类型，选择对应工具或文档：\n\n| 用户问题类型 | 使用 |\n|------------|------|\n| 这个品能不能做 | `scripts/product_score.py` + `references/product-selection.md` |\n| 卖多少钱／能赚多少／保本价／达人佣金怎么算 | `scripts/pricing.py` |\n| 广告怎么投／ROI 多少才不亏／出价多少 | `scripts/ad_calc.py` |\n| 有流量不出单／哪个环节有问题 | `scripts/diagnose.py` |\n| 文案能不能这么写／会不会违规 | `scripts/compliance.py` |\n| 标题怎么写／批量出标题候选 | `scripts/title_gen.py` + `references/listing-and-content.md` |\n| 备多少货／会不会断货／压多少资金 | `scripts/inventory.py` |\n| 给我实时费率/进货价/搜索量再算 | `scripts/live.py`（先 `sources`/`schema` 拉数据，再 `plan` 灌入计算器） |\n| 平台怎么起量／算法逻辑 | `references/platform-playbook.md` |\n| 标题主图详情页／短视频／直播 | `references/listing-and-content.md` |\n| 日常怎么做／大促怎么排／怎么防违规 | `references/operations-playbook.md` |\n| Temu 全托管半托管／跨境报价与合规 | `references/crossborder-temu.md` |\n\n## 可执行工具\n\n全部脚本使用 Python 3 标准库，无第三方依赖，可直接运行。\n所有脚本均支持 `--json` 输出结构化结果，支持 `--self-test` 自检。\n运行前先切换到 `scripts/` 目录，或确保该目录在 `PYTHONPATH` 中。\n\n### 1. 定价与利润测算 —— pricing.py\n\n采用 100 单基准法核算，把退货造成的去程运费、包材、损耗全部计入，\n这是\"卖爆了却在亏钱\"的根本原因。\n\n```bash\npython scripts/pricing.py --cost 35 --price 129 --platform douyin \\\n    --shipping 4.5 --packaging 1.5 --return-rate 30 --ad-ratio 18\n```\n\n输出单均净利、净利率、毛利率、**保本售价**、**保本 ROI** 与成本结构。\n`--list-platforms` 查看内置平台费率参考表（含 Temu）。\n抖音/快手/视频号带货场景用 `--daren-ratio` 计入达人/分销佣金\n（按有效成交额计，退款单佣金退回）。\n\n**关键用法**：在任何定价、报价、谈达人佣金、参加活动前先跑一次。\n得到的\"保本售价\"是价格底线，\"保本 ROI\"是投放的生死线。\n\n### 2. 投放测算 —— ad_calc.py\n\n适用于直通车、万相台、巨量千川、京准通、多多推广等所有 CPC 场景。\n\n```bash\npython scripts/ad_calc.py --price 129 --gross-margin 60 --cvr 2.5 --cpc 1.2 \\\n    --budget 2000 --target-roi 4\n```\n\n输出 UV 价值、当前 ROI、保本 ROI、**可承受最高 CPC**、CPA、\n日预算测算，以及达成目标 ROI 所需的 CPC 或转化率（二选一路径）。\n\n**核心恒等式**：`ROI = UV价值 ÷ CPC`，`保本ROI = 1 ÷ 毛利率`。\n毛利率参数应使用 `pricing.py` 算出的毛利率，两个工具串联使用。\n\n### 3. 转化漏斗诊断 —— diagnose.py\n\n不看哪个数字低，而是看**哪个环节相对行业基准差得最多**，\n偏离最大的环节即为瓶颈，优先修复它的投入产出比最高。\n\n```bash\npython scripts/diagnose.py --impression 200000 --click 2000 --cart 200 \\\n    --order 110 --paid 55 --refund 8 --gmv 6600\n```\n\n输出各环节转化率与基准对比、瓶颈定位、按优先级排序的处方，\n以及\"瓶颈修复到基准后订单能涨多少\"的提升模拟。\n\n**使用原则**：转化链路存在短板时加预算等于放大亏损，先诊断再投放。\n\n### 4. 选品六维评分 —— product_score.py\n\n利润空间 25%、市场需求 20%、竞争强度 20%、退货风险 15%、\n物流成本 10%、供应链 10%，加权总分 100。\n\n```bash\npython scripts/product_score.py --gross-margin 62 --search-index 8000 \\\n    --trend up --supply-ratio 3.2 --return-rate 18 --weight 0.4 \\\n    --moq 100 --restock-days 10\n```\n\n输出总分、各维度得分、短板识别与改进方向。\n阈值：≥75 优质款，60–74 可做款小批量测试，<60 建议放弃。\n\n### 5. 合规检查 —— compliance.py\n\n内置 216 条广告法违禁词库，分三级风险：\nP0 明令禁止（绝对化用语，命中即违法）、P1 需要资质、P2 真实性约束。\n\n```bash\npython scripts/compliance.py --text \"全网最低价，销量第一\"\npython scripts/compliance.py --file detail.txt --min-level P0\n```\n\n输出命中词、风险级别、原文上下文与整改建议。\n**命中 P0 时进程返回码为 1**，可用于批处理或 CI 流程拦截。\n\n**强制要求**：所有对外文案（标题、主图文字、详情页、短视频脚本、\n直播话术、客服话术）发布前必须扫描，P0 必须清零。\n\n### 6. 标题生成 —— title_gen.py\n\n按「核心词 + 属性词 + 场景词」结构公式批量拼装候选标题，\n受平台字数上限硬约束（超长自动从尾部截断、核心词必保留），\n每条候选自动过 compliance 词库预检——**命中 P0 的候选直接剔除**，\nP1/P2 仅标注提醒。\n\n```bash\npython scripts/title_gen.py --core \"汽车LED大灯\" \\\n    --attrs \"激光,双铜管,IP68,H7\" --scenes \"货车,夜行\" --platform pdd --n 5\n```\n\n输出按「核心词位置 + 长度利用率 + 关键词覆盖」打分排序的候选列表。\n字数上限为公开参考值（淘宝/拼多多/抖音 60 字符、京东 50、小红书 40），\n可用 `--limit` 覆盖，发布前以商家后台实际提示为准。\n\n### 7. 备货与资金占用测算 —— inventory.py\n\n把\"备多少货、会不会断货、压多少资金\"量化：\n补货点 ROP = 日均销量 ×（供货周期 + 安全天数），\n建议补货量按 MOQ 向上取整，资金占用 = 补货量 × 单件成本。\n\n```bash\npython scripts/inventory.py --daily-sales 50 --lead-days 7 \\\n    --stock 200 --cost 18 --moq 100 --budget 8000\n```\n\n输出补货点、可售天数、建议补货量、资金占用、断货风险三级分级、\n滞销预警（在库可售 >90 天）与预算约束下的最大可备量。\n适用于自采囤货与 Temu 半托管海外仓场景；一件代发无需备货。\n\n### 8. 实时数据桥接 —— live.py（让前述工具\"实时可用\"）\n\n前面七个工具再准，也依赖**真实入参**：你填的佣金率、退货率、进货价、搜索量，\n若靠拍脑袋就会失真。本脚本把\"先用 WebSearch/WebFetch 拉当前真实值，\n再一键灌入计算器\"标准化，解决\"估算即翻车\"的根因。\n\n```bash\n# 1) 看某平台该去哪拉实时数据（佣金率/退货率/进货价/搜索量）\npython scripts/live.py sources --platform douyin\n\n# 2) 看 live_data.json 该收集哪些字段、单位是什么\npython scripts/live.py schema\n\n# 3) 把拉到的实时值写入 live_data.json 后，生成可直接执行的命令\npython scripts/live.py plan --in live_data.json\n```\n\n`live.py` 自身不抓电商站点（规避反爬与 JS 渲染），而是：\n- `sources` 给出每个平台**官方公示页 / 公开指数工具**的权威 URL，由 Agent\n  用 WebFetch 拉取当前真实佣金率、类目退货率、1688 进货价、关键词搜索量；\n- `plan` 按\"先 pricing 算毛利率 → 再 product_score/ad_calc 串联\"的顺序，\n  生成 pricing / product_score / ad_calc / diagnose 四段命令，并标注缺失字段；\n- `stamp` 输出当前日期，报告自动带上\"数据截至 YYYY-MM-DD\"水印，\n  始终提醒以商家后台为准；\n- `fetch fx` 演示本机直连实时公开接口（汇率，跨境成本换算用），\n  网络受限时优雅降级并提示改用 Agent 侧 WebFetch。\n\n**关键约束**：`live_data.json` 里的 `gross_margin` 必须由 `pricing` 输出，\n`plan` 会强制要求先跑 pricing，保证各工具的数据链路自洽（见 L2 测试）。\n\n### 共享数据模块 —— platform_fees.py\n\n`scripts/platform_fees.py` 是上述工具的**共享费率/基准表**（八大平台佣金率、\n支付费率、行业转化基准），被 pricing / diagnose / product_score 共同 import。\n可直接查看或校准：\n\n```bash\npython scripts/platform_fees.py        # 打印平台费率参考表\n```\n\n表内为公开参考区间，平台政策持续变化，使用前请以商家后台最新公示为准；\n任何数值都可用各脚本的 `--commission` 等参数手动覆盖。\n\n## 知识库\n\n需要方法论、平台规则或实操细节时，按需读取以下文档：\n\n- **`references/platform-playbook.md`** —— 六大国内平台流量机制对比、\n  淘宝搜索权重与坑产逻辑、拼多多价格力与活动起量、抖音赛马机制与 GPM、\n  京东与小红书打法、跨平台通用铁律。\n- **`references/product-selection.md`** —— 选品四道门槛（合规/利润/\n  需求/竞争）、评分模型说明、分品类退货率参考、四种产品角色矩阵、\n  供应链评估与备货公式、六大选品陷阱。\n- **`references/listing-and-content.md`** —— 各平台标题字数与结构公式、\n  主图五图法则、详情页九屏黄金结构、短视频脚本框架、直播节奏与货盘、\n  评价运营、发布前检查清单。\n- **`references/operations-playbook.md`** —— GMV 公式拆解、核心指标\n  定义与健康区间、日周月运营节奏、提升客单价六法、大促五阶段节奏、\n  售后与差评处理、平台与法律风控红线、常见问题速查。\n- **`references/crossborder-temu.md`** —— Temu 全托管/半托管/本对本\n  三模式对比、核价逻辑与保本供货价测算、欧美合规红线（欧代/EPR/CE/\n  FCC/CPC）、履约罚则口径、与本技能工具的串联路径。\n\n## 典型工作流\n\n### 工作流 A：评估一个新品能不能做\n\n1. 用 `product_score.py` 做六维评分，得到初步结论\n2. 若 ≥60 分，用 `pricing.py` 精算利润，确认保本售价与毛利率\n3. 用 `ad_calc.py` 代入毛利率，算出保本 ROI 与最高可承受 CPC\n4. 判断该 CPC 在目标类目是否可实现（对比行业平均 CPC）\n5. 读 `references/product-selection.md` 核对合规资质与供应链风险\n6. 输出结论：做 / 不做 / 小批量测试，并给出价格与投放边界\n\n### 工作流 B：店铺有流量但不出单\n\n1. 用 `diagnose.py` 输入完整漏斗数据，定位瓶颈环节\n2. 按输出的处方逐条执行，不要跳过优先级\n3. 若瓶颈在点击率 → 读 `listing-and-content.md` 主图章节\n4. 若瓶颈在转化率 → 读详情页九屏结构与评价运营章节\n5. 若瓶颈在支付率 → 检查运费门槛、优惠券、库存与催付\n6. 修复后重新跑 `diagnose.py` 对比验证\n\n### 工作流 C：投放亏损，ROI 做不上去\n\n1. 用 `pricing.py` 确认真实毛利率（多数人此处高估）\n2. 用 `ad_calc.py` 算保本 ROI，与实际 ROI 对比\n3. 若实际 ROI < 保本 ROI，用 `--target-roi` 反推需要的 CPC 或转化率\n4. 优先级固定为：提转化率 > 降 CPC > 提客单价\n5. 转化率问题回到工作流 B 做漏斗诊断\n\n### 工作流 D：撰写或审核商品文案\n\n1. 用 `title_gen.py` 按平台字数上限批量产出候选标题（P0 候选已自动剔除）\n2. 读 `references/listing-and-content.md` 对应章节获取结构模板\n3. 按平台字数限制与结构公式撰写\n4. 用 `compliance.py` 扫描，P0 必须清零，P1 确认资质，P2 确认可举证\n5. 对照文档末尾的发布前检查清单逐项确认\n\n### 工作流 E：用实时数据决策（推荐默认路径）\n\n当用户的提问绑定到**具体商品 / 关键词 / 平台**时，不要凭记忆填参数，\n走实时链路，让结论\"实时可用\"：\n\n1. 用 `live.py sources --platform <平台>` 拿到该平台的实时数据源 URL\n2. 用 WebSearch / WebFetch 拉取当前真实值：\n   - 类目佣金率（平台资费公示页）\n   - 类目退货率（平台/行业报告）\n   - 1688 实时进货价（搜关键词按销量排序）\n   - 关键词月搜索量 / 趋势（巨量算数、微信指数、百度指数等）\n3. 把数值写入 `live_data.json`\n4. 用 `live.py plan --in live_data.json` 生成执行命令，按序执行\n5. 报告顶部带上\"数据截至 <日期>\"水印，并提示以商家后台校准\n\n### 工作流 F：Temu 报价与备货\n\n1. 读 `references/crossborder-temu.md` 选定模式（全托管/半托管）并核对合规红线\n2. 用 `pricing.py --platform temu` 反推保本供货价：全托管把供货价当售价；\n   半托管把海外仓与尾程成本计入 `--shipping` / `--other`\n3. 用 `inventory.py` 算海外仓备货：头程周期长时提高 `--safety-days`\n4. 用 `title_gen.py --limit 80` 产出英文标题候选（公开口径 80 字符，\n   以后台为准）并人工本地化\n5. 报价、备货量、罚则口径全部以 Temu 卖家中心最新公示复核\n\n## 铁律\n\n1. **先算账，再做事。** 定价、投放、报活动、谈佣金之前，\n   必须先跑 `pricing.py` 和 `ad_calc.py`，没有保本售价与保本 ROI\n   这两个数字就是在盲目决策。\n2. **诊断优先于加预算。** 转化链路有短板时加预算只会放大亏损。\n3. **合规先于增长。** 广告法罚则起点二十万元，一次翻车抵掉全年利润。\n   所有对外文案先过 `compliance.py`。\n4. **不照搬跨平台打法。** 抖音的内容逻辑与淘宝的搜索逻辑完全不同。\n5. **数据以商家后台为准。** 本技能内置的费率、行业基准均为公开参考值，\n   实际决策必须用后台真实数据校准。\n6. **优先用实时数据，不凭记忆填参。** 用户给了具体商品/平台时，\n   先用 `live.py` + WebSearch/WebFetch 拉当前真实费率、退货率、进货价、\n   搜索量，再灌入计算器；记忆值只作缺失时的兜底，并明确标注为估算。\n7. **不编造数据。** 无法确认的数字应明确说明其为估算或参考区间，\n   并提示用户核实来源。\n\n## 免责声明\n\n本技能提供的费率、行业基准、退货率区间等均为公开信息与行业经验值，\n平台规则持续变化，使用前须以各平台官方最新公示为准。\n合规检查结果为风险自查提示，不构成法律意见，\n具体认定以市场监管部门为准。\n\nFile v1.2.0:README.md\n\n# 国内电商全链路运营 Skill（cn-ecommerce-ops）\n\n![使用演示](assets/demo.gif)\n\n一个面向 AI Agent 的**国内电商运营专家技能包**，覆盖淘宝、天猫、京东、\n拼多多、抖音电商、小红书、视频号七大国内平台及 Temu 跨境。\n\n核心主张只有一句：**先算账，再做事。**\n\n多数电商决策失误来自三件事——不算真实利润（漏算退货与推广成本）、\n不算保本 ROI（盲目投放）、不查合规（广告法罚则起点二十万元）。\n本技能为这三件事各提供了一个可执行、可验证的确定性工具。\n\n![tests](https://img.shields.io/badge/tests-48%20passed-brightgreen)\n![python](https://img.shields.io/badge/python-3.9%2B-blue)\n![deps](https://img.shields.io/badge/dependencies-none-lightgrey)\n![license](https://img.shields.io/badge/license-MIT-green)\n![stars](https://img.shields.io/github/stars/g305595965/cn-ecommerce-ops?style=social)\n![forks](https://img.shields.io/github/forks/g305595965/cn-ecommerce-ops?style=social)\n![issues](https://img.shields.io/github/issues/g305595965/cn-ecommerce-ops)\n\n---\n\n## 为什么需要它\n\n大模型对电商的了解通常停留在\"多做内容、优化主图、提升转化率\"这类\n正确但无用的建议。真正的运营决策需要的是**数字**：\n\n- 这个价格到底赚不赚钱？退货率 30% 之后还剩多少？\n- 投放 ROI 做到多少才不亏？最高能出多少钱一个点击？\n- 有流量不出单，问题到底出在哪一环？\n- 这句文案会不会让我被罚二十万？\n\n本技能把这些问题变成可以直接算出答案的命令。\n\n---\n\n## 七个可执行工具 + 实时数据桥接\n\n全部使用 Python 3 标准库实现，**零第三方依赖**，每个脚本都内置自检。\n\n| 脚本 | 作用 | 关键输出 |\n|------|------|---------|\n| `scripts/pricing.py` | 定价与利润测算 | 单均净利、**保本售价**、**保本 ROI**、成本结构 |\n| `scripts/ad_calc.py` | 付费投放测算 | UV 价值、**可承受最高 CPC**、目标 ROI 反推 |\n| `scripts/diagnose.py` | 转化漏斗诊断 | 瓶颈环节定位、优先级处方、提升模拟 |\n| `scripts/product_score.py` | 选品六维评分 | 综合得分、短板识别与改进方向 |\n| `scripts/compliance.py` | 广告法合规检查 | 216 条违禁词库，三级风险分级与整改建议 |\n| `scripts/title_gen.py` | **商品标题生成** | 按平台字数上限批量产出候选，P0 违禁词自动剔除 |\n| `scripts/inventory.py` | **备货与资金占用测算** | 补货点 ROP、建议补货量、资金占用、断货/滞销风险 |\n| `scripts/live.py` | **实时数据桥接** | 拉取当前真实费率/进货价/搜索量，一键灌入上述计算器 |\n\n> `scripts/platform_fees.py` 是共享数据模块（八大平台佣金率、支付费率、\n> 行业转化基准），被 pricing / diagnose / product_score 共同引用，\n> 可用 `python scripts/platform_fees.py` 直接查看，数值均可用各脚本参数覆盖。\n\n### 让工具\"实时可用\"：live.py\n\n前面七个工具再准，也依赖**真实入参**。与其凭记忆填佣金率、退货率、进货价、\n搜索量，`live.py` 把\"先拉实时数据、再灌入计算器\"标准化：\n\n```bash\n# 看某平台该去哪拉实时数据（官方公示页 / 公开指数工具，无需 API key）\npython scripts/live.py sources --platform douyin\n\n# 看 live_data.json 该收集哪些字段、单位是什么\npython scripts/live.py schema\n\n# 把 WebSearch/WebFetch 拉到的实时值写入 live_data.json，生成执行命令\npython scripts/live.py plan --in live_data.json\n```\n\n`plan` 会按\"先 `pricing` 算毛利率 → 再 `product_score` / `ad_calc` 串联\"的顺序\n生成命令，并标注缺失字段；报告自动带上\"数据截至 YYYY-MM-DD\"水印。\n`live.py fetch fx` 还能本机直连实时汇率接口（跨境成本换算用），网络受限时\n优雅降级并提示改用 Agent 侧 WebFetch。\n\n详见 SKILL.md 的「实时数据路由」与工作流 E。\n\n### 亮点设计\n\n**1. 定价用 100 单基准法，而不是简单减法**\n\n退货产生的去程运费、包材、损耗都不可回收，这是\"卖爆了却在亏钱\"的\n根本原因。脚本模拟发出 100 单、其中 r% 退货，分别核算收入与成本，\n再折算回单均利润。\n\n```bash\npython scripts/pricing.py --cost 35 --price 129 --platform douyin \\\n    --shipping 4.5 --packaging 1.5 --return-rate 30 --ad-ratio 18\n```\n\n**2. 诊断看的是相对基准的偏离度，不是绝对值高低**\n\n哪个环节相对行业基准差得最多，哪个才是真瓶颈，修复它的投入产出比最高。\n\n```bash\npython scripts/diagnose.py --impression 200000 --click 2000 \\\n    --order 110 --paid 55 --gmv 6600\n```\n\n```\n  [!]  点击率         1.00%  基准 2.0~5.0%    偏低 偏离 50.0%\n  [OK] 下单率         5.50%  基准 3.0~8.0%    正常\n  [!]  支付率        50.00%  基准 60.0~85.0%  偏低 偏离 16.7%\n\n--- 瓶颈定位 ---\n  最大瓶颈: 曝光 -> 点击（点击率）\n  可能归因: 主图/短视频首帧、标题、价格带、人群精准度\n```\n\n**3. 合规检查可接入自动化流程**\n\n命中 P0（广告法明令禁止的绝对化用语）时进程返回码为 `1`，\n可直接用于批处理或 CI 拦截。\n\n```bash\npython scripts/compliance.py --file detail.txt --min-level P0\n```\n\n**4. 标题生成即过合规预检**\n\n`title_gen.py` 按「核心词 + 属性词 + 场景词」结构公式拼装候选，\n受平台字数上限硬约束（核心词必保留），每条候选自动过 compliance 词库，\n命中 P0 的直接剔除——产出的标题天然可发布。\n\n```bash\npython scripts/title_gen.py --core \"汽车LED大灯\" \\\n    --attrs \"激光,双铜管,IP68,H7\" --scenes \"货车,夜行\" --platform pdd\n```\n\n**5. 备货决策量化**\n\n`inventory.py` 把补货点、备货量、资金占用算清楚：ROP = 日均销量 ×\n（供货周期 + 安全天数），补货量按 MOQ 取整，断货/滞销双风险分级。\n抖音/快手带货还可用 `pricing.py --daren-ratio 20` 把达人佣金计入利润。\n\n```bash\npython scripts/inventory.py --daily-sales 50 --lead-days 7 \\\n    --stock 200 --cost 18 --moq 100\n```\n\n---\n\n## 五册知识库\n\n| 文档 | 内容 |\n|------|------|\n| `references/platform-playbook.md` | 六大国内平台流量机制对比、淘宝坑产逻辑、拼多多价格力、抖音赛马与 GPM、小红书 CES、冷启动路径 |\n| `references/product-selection.md` | 选品四道门槛、分品类退货率参考、四种产品角色矩阵、供应链评估与备货公式 |\n| `references/listing-and-content.md` | 标题结构公式、主图五图法则、详情页九屏结构、短视频脚本框架、直播节奏与货盘 |\n| `references/operations-playbook.md` | GMV 公式拆解、指标健康区间、日周月节奏、大促五阶段、风控红线速查 |\n| `references/crossborder-temu.md` | Temu 全托管/半托管/本对本对比、核价逻辑、欧美合规红线（欧代/EPR/CE/FCC）、履约罚则口径 |\n\n---\n\n## 安装\n\n### WorkBuddy\n\n```bash\ngit clone https://github.com/g305595965/cn-ecommerce-ops.git ~/.workbuddy/skills/cn-ecommerce-ops\n```\n\n### Claude Code\n\n```bash\ngit clone https://github.com/g305595965/cn-ecommerce-ops.git ~/.claude/skills/cn-ecommerce-ops\n```\n\n### 手动安装\n\n下载仓库 ZIP，解压后将整个目录放入对应的 `skills/` 目录，\n确保目录内直接包含 `SKILL.md`。\n\n安装后重启客户端，向 AI 提问\"帮我算一下这个品能不能做\"即可自动触发。\n\n---\n\n## 直接当命令行工具用\n\n不依赖任何 AI 客户端，脚本本身就是完整的命令行工具：\n\n```bash\ncd scripts\n\n# 查看内置平台费率参考表\npython pricing.py --list-platforms\n\n# 算保本 ROI 和最高出价\npython ad_calc.py --price 129 --gross-margin 60 --cvr 2.5 --cpc 1.2 --target-roi 4\n\n# 选品评分\npython product_score.py --gross-margin 62 --search-index 8000 --trend up \\\n    --supply-ratio 3.2 --return-rate 18 --weight 0.4 --moq 100 --restock-days 10\n\n# 导出完整违禁词库\npython compliance.py --list-rules\n\n# 批量生成合规标题候选\npython title_gen.py --core \"保温杯\" --attrs \"316不锈钢,500ml\" --platform taobao\n\n# 备货与资金占用测算\npython inventory.py --daily-sales 50 --lead-days 7 --stock 200 --cost 18 --moq 100\n```\n\n所有脚本均支持 `--json` 输出结构化结果，方便二次开发与集成。\n\n---\n\n## 测试\n\n```bash\npython tests/run_all.py\n```\n\n三层验证，共 48 项：\n\n- **L1 单元层** —— 逐个运行各脚本内置自检（含公式自洽、单调性、异常拦截）\n- **L2 集成层** —— 验证工具链数据自洽，例如 `pricing.py` 与 `ad_calc.py`\n  两个独立脚本算出的保本 ROI 必须一致、保本售价代回后净利必须归零\n- **L3 结构层** —— 校验 SKILL.md 元数据、文件完整性，\n  以及文档中引用的每一个脚本路径是否真实存在（防止文档说谎）\n\n---\n\n## 数据来源与免责声明\n\n- 内置的平台费率、行业转化基准、分品类退货率均为**公开信息与行业经验值**，\n  文中已逐项标注。平台规则持续变化，实际决策**必须以各平台商家后台\n  最新公示为准**。\n- 合规检查基于《广告法》（2021 修正）第九条等条款及常见执法口径整理，\n  结果为**风险自查提示，不构成法律意见**，具体认定以市场监管部门为准。\n- 部分词汇在特定语境下可合规（如已取得对应批准文号），需结合实际判断。\n\n---\n\n## 贡献\n\n欢迎提 Issue 或 PR，尤其欢迎以下方向：\n\n- 补充或修正平台费率与规则（请附官方来源链接）\n- 扩充违禁词库与整改建议\n- 补充分品类的转化率与退货率基准数据\n- 修正计算模型中的口径问题\n\n提交 PR 前请运行 `python tests/run_all.py` 确保全部通过。\n\n---\n\n## 更新日志\n\n### v1.2.0（2026-09-07）\n\n- 新增 `scripts/title_gen.py`：按结构公式批量生成标题候选，\n  平台字数硬约束 + 合规预检，P0 候选自动剔除\n- 新增 `scripts/inventory.py`：补货点 ROP、建议补货量（MOQ 取整）、\n  资金占用、断货三级风险与滞销预警、预算约束反推\n- `pricing.py` 新增 `--daren-ratio`：达人/分销佣金按有效成交额计入，\n  保本售价反解同步支持\n- 新增 Temu 平台：`platform_fees.py` 费率条目、`live.py` 数据源、\n  `references/crossborder-temu.md` 跨境手册（模式对比/核价/合规红线）\n- `compliance.py` 词库扩充至 216 条（新增保健食品功能声称、\n  排他性表述、承诺兑现、产地真实性等类目）\n- 测试三层 48 项全通过\n\n### v1.1.0（2026-08-15）\n\n- 新增实时数据桥接 `live.py`，计算器\"实时可用\"\n- 修复 plan 生成命令的布尔旗标与参数映射 bug\n\n### v1.0.0（2026-08-09）\n\n- 首个版本：五个可执行工具 + 四册知识库\n\n---\n\n## License\n\n[MIT](LICENSE)\n\nFile v1.2.0:_meta.json\n\n{\n  \"ownerId\": \"kn7d4jg6kwefccgm7gdmxkzkv18c4neh\",\n  \"slug\": \"cn-ecommerce-ops\",\n  \"version\": \"1.2.0\",\n  \"publishedAt\": 1788751628940\n}\n\nFile v1.2.0:references/crossborder-temu.md\n\n# Temu 跨境运营手册（全托管 / 半托管 / 本对本）\n\n> 本手册基于 2026 年公开资料与卖家社群口径整理。Temu 规则迭代极快，\n> **所有费率、保证金、时效数字务必以 Temu 卖家中心（seller.kuajingmaihuo.com）\n> 规则中心与招商经理的最新口径为准**。多方来源数字冲突处本文已标注。\n\n## 一、三种模式对比\n\n| 维度 | 全托管 | 半托管 | 本对本 |\n|------|--------|--------|--------|\n| 本质 | 供货模式：你是平台供应商 | 卖家自履约 + 平台流量 | 海外本土店 |\n| 货物位置 | 发 Temu 国内集运仓 | 你的海外仓 / 3PL | 目标国本土仓 |\n| 定价权 | 无（平台核价定价） | 有（系统给参考价，可申诉） | 基本自主 |\n| 保证金 | 约 ¥1,000（可退） | 约 ¥10,000 或 $1,400 | 依站点政策 |\n| 佣金 | 名义 0（差价隐含 2%~5%） | 按类目约 6%~15%（口径不一） | 依站点政策 |\n| 回款周期 | 慢（约 30 天上下） | 快（确认收货 T+1，约 8 天） | 依站点 |\n| 履约时效 | 平台负责 | 严考核（48h 上网率等） | 2~5 天签收 |\n| 适合 | 源头工厂、清库存、测款 | 有海外仓/物流资源的卖家 | 有海外主体的品牌卖家 |\n\n**选型铁律**：无跨境经验先全托管测款，但不要把全托管当长期利润来源——\n定价权为零意味着利润天花板由平台决定。有海外仓能力尽早转半托管。\n\n## 二、核价逻辑（全托管的生死线）\n\n- 全托管报价 = 你愿意接受的最低单件回款。平台核价普遍对标 1688 同款价\n  与全网低价，报价虚高直接被拒或限流。\n- 2026 年《互联网平台价格行为规则》生效后，平台已取消\"强制跟价\"，\n  价格在流量分配中的权重下降，评分/履约/合规权重上升——但低价竞争力\n  仍是入池前提。\n- 报价测算路径：先用 `scripts/pricing.py` 按\"供货价=售价\"反推你的保本\n  供货价（成本+头程分摊+损耗），报价低于此值就是亏本供货。\n- 半托管定价：系统核价有异议可在后台提交成本凭证申诉（公开口径称\n  2 个工作日内处理，以实际为准）。\n\n## 三、合规红线（2026 严查项）\n\n无以下文件，欧美站点直接下架+罚款：\n\n1. **欧代 / 英代 / 美代**：欧盟、英国、美国站点的授权代表（公开行情约\n   ¥500~2000/年，服务商报价差异大）。\n2. **EPR 注册**：包装法、电池法、WEEE 等，按类目与站点（约 ¥300~1500/类目）。\n3. **产品认证**：CE（欧盟）、FCC（美国电子类）、CPC/CPSIA（母婴儿童）、\n   FDA（食品接触/美妆按类目）。\n4. **知识产权**：标题/图片含品牌词、卡通形象、专利外观 = 下架 + 扣罚，\n   严重封店。无品牌散件也要排查外观专利。\n\n汽车配件类（如 LED 车灯）特别注意：涉及车辆安全件的类目在部分站点\n有额外认证要求（如 DOT/E-mark），上架前必须在卖家中心核对类目资质清单。\n\n## 四、履约与罚则（卖家社群口径，以后台罚则页为准）\n\n- 订单履约率要求 ≥95%，入仓质检通过率 ≥90%（社群口径）；断货一次\n  可能导致链接权重清零。\n- 延迟发货、缺货、质检不合格均有梯度罚款；质量事故罚款可达数万元级\n  （社群有个案报道），务必留足质检余量。\n- 半托管 48 小时上网率等时效考核趋严，选择海外仓/尾程服务商时优先\n  看轨迹上网速度而非单纯价格。\n\n## 五、与本技能工具的串联\n\n1. **测款**：`scripts/product_score.py` 评估品类（Temu 偏好轻小件、标品、\n   低客单；重货大件基本被劝退）。\n2. **报价**：`scripts/pricing.py --platform temu`，把供货价当售价算保本线；\n   半托管把海外仓+尾程成本计入 `--shipping` 与 `--other`。\n3. **备货**：海外仓备货用 `scripts/inventory.py` 测算——头程海运 30 天+\n   的供货周期下，安全天数建议 15 天以上（`--safety-days 15`）。\n4. **标题**：英文标题 ≤80 字符（公开口径），用 `scripts/title_gen.py\n   --limit 80` 生成候选后人工本地化。\n5. **实时数据**：`scripts/live.py sources --platform temu` 获取核验入口。\n\n## 六、常见坑速查\n\n- 全托管爆款可能被平台要求转半托管（\"同款绑定\"社群口径），提前评估\n  海外仓能力。\n- 回款周期长，现金流按 45 天以上规划（全托管）。\n- 单日上新有上限（公开口径 400 条/日，与店铺动销挂钩），精铺优于铺货。\n- 保证金从回款中冻结而非预缴（2026 年口径），关店无违规可退。\n\n> 免责声明：以上为公开信息整理，不构成平台官方规则解释；\n> 违规认定与罚则以 Temu 卖家中心公示及协议为准。\n\nFile v1.2.0:references/listing-and-content.md\n\n# 商品呈现与内容创作手册\n\n> 流量进来之后，能否转化全靠这一环。所有对外文案发布前，\n> 必须先经过 `scripts/compliance.py` 合规扫描。\n\n---\n\n## 一、标题优化\n\n### 各平台字数限制\n| 平台 | 上限 | 备注 |\n|------|------|------|\n| 淘宝 / 天猫 | 30 汉字（60 字符） | 用满，不浪费字符 |\n| 京东 | 30 汉字左右 | 品牌词前置 |\n| 拼多多 | 60 字符 | 简洁直白，突出价格力 |\n| 抖音商城 | 30 汉字左右 | 口语化，贴近搜索习惯 |\n| 小红书笔记 | 20 汉字（显示约 20 字） | 前 10 字最关键 |\n\n### 标题结构公式\n```\n营销词 + 品牌词 + 核心词 + 属性词 + 场景词 + 长尾词\n```\n\n**示例**（女士针织衫）：\n```\n2024新款 XX品牌 针织开衫 女 宽松 慵懒风 春秋 外搭 小个子 上衣\n```\n\n### 关键原则\n1. **核心词必须完整可切分** —— 不要把\"针织开衫\"拆成\"针织 时尚 开衫\"，\n   否则搜索引擎无法完整匹配\"针织开衫\"这个词。\n2. **新品用长尾词，成熟品抢大词** —— 新品没有权重，抢大词只会被淹没。\n   先用\"针织开衫女小个子慵懒风\"这类精准长尾词吃转化。\n3. **属性词必须与后台属性一致** —— 不一致会被判定为标题违规或降权。\n4. **不堆砌无关热词** —— 引来不精准流量会打乱人群标签，得不偿失。\n5. **禁用广告法违禁词** —— \"最\"字系、\"第一\"、\"国家级\"等一律不能出现。\n\n### 关键词来源\n- 平台搜索下拉框（真实用户搜索）\n- 竞品标题拆解（取交集高频词）\n- 生意参谋 / 抖音电商罗盘 / 京东商智的搜索词分析\n- 直通车关键词报表（有真实点击数据的词最可靠）\n\n---\n\n## 二、主图设计（决定点击率）\n\n### 五图 + 一视频的标准配置\n| 位置 | 作用 | 要点 |\n|------|------|------|\n| 主图 1 | 抓眼球 | 产品主体清晰 + 一句核心卖点（≤8字） |\n| 主图 2 | 卖点强化 | 最强差异化功能，用对比或数据体现 |\n| 主图 3 | 场景化 | 产品在真实使用场景中的样子 |\n| 主图 4 | 细节特写 | 材质、工艺、做工，建立品质感 |\n| 主图 5 | 信任状 | 资质证书、检测报告、售后承诺 |\n| 主图视频 | 综合展示 | 15–30 秒，前 3 秒必须有信息量 |\n\n### 提升点击率的实操要点\n- **左上角是黄金视觉区**，最重要的信息放这里（符合 F 型视觉动线）\n- 文字**不超过图片面积 20%**（平台规则），且必须大而清晰，\n  手机上缩略图只有指甲盖大小，小字等于没有\n- **色彩要跳出搜索结果页**：竞品都用白底，你用彩底就能跳出来\n- **主图必须 A/B 测试**，用直通车小预算测点击率，\n  跑出高于行业均值的图再放大投放，不要凭审美决定\n\n---\n\n## 三、详情页黄金结构\n\n用户决策路径：**我有什么问题 → 你能解决吗 → 凭什么信你 → 为什么现在买**\n\n| 屏序 | 内容 | 目的 |\n|------|------|------|\n| 第 1 屏 | 核心卖点 + 使用场景大图 | 3 秒内说清\"这是什么、解决什么\" |\n| 第 2 屏 | 痛点场景还原 | 引发共鸣：\"这说的就是我\" |\n| 第 3 屏 | 解决方案 + 核心功能 | 给出答案 |\n| 第 4 屏 | 参数与规格 | 满足理性决策需求 |\n| 第 5 屏 | 细节展示 | 材质、做工、工艺 |\n| 第 6 屏 | 信任背书 | 资质、检测报告、销量、媒体报道 |\n| 第 7 屏 | 用户评价 / 买家秀 | 从众心理，真实感最重要 |\n| 第 8 屏 | 售后保障 | 消除最后顾虑（七天无理由、运费险、质保） |\n| 第 9 屏 | 促销信息 + 行动号召 | 临门一脚，制造合理紧迫感 |\n\n**核心原则**：\n- **前三屏决定 70% 的跳失**，最强的内容必须前置\n- 移动端优先，单张图高度不超过 1200px，避免加载过慢\n- **不要用大段文字**，用图 + 短句，用户是\"扫\"不是\"读\"\n- 促销紧迫感必须**真实**（虚构倒计时构成价格欺诈）\n\n---\n\n## 四、短视频带货脚本框架\n\n### 黄金 3 秒开场（决定生死）\n四种经过验证的开场方式：\n1. **痛点直击** —— \"你是不是也这样...\"\n2. **结果前置** —— 直接展示使用后的效果\n3. **反常识冲突** —— \"千万别再这样做了\"\n4. **身份代入** —— \"小个子女生一定要看\"\n\n### 30–60 秒脚本结构\n```\n0–3s   黄金开场（痛点/结果/冲突）\n3–10s  问题放大（为什么这件事很麻烦）\n10–25s 产品出场 + 核心卖点演示（要看得见的效果）\n25–40s 使用场景 + 效果展示\n40–50s 信任背书（销量/资质/真实反馈）\n50–60s 行动号召 + 利益点（限时优惠、赠品）\n```\n\n### 关键指标与优化方向\n| 指标不达标 | 优化位置 |\n|-----------|---------|\n| 3 秒完播率低 | 开场没抓住人，重做前 3 秒 |\n| 完播率低 | 中段节奏拖沓，删冗余镜头 |\n| 点击率低 | 挂车时机不对，或产品与内容不匹配 |\n| 转化率低 | 落地页承接问题，看详情页与价格 |\n\n---\n\n## 五、直播运营\n\n### 单场直播节奏（15–25 分钟一个循环）\n```\n1. 引流憋单（3–5 分钟）\n   用福利款/秒杀留人，拉停留时长，积累在线人数\n2. 产品讲解（8–12 分钟）\n   痛点 → 卖点 → 演示 → 对比 → 信任状\n3. 逼单成交（3–5 分钟）\n   限时限量、价格锚点、赠品叠加，倒数上链接\n4. 循环往复\n```\n\n### 货盘结构\n- **福利款** —— 引流留人，亏本或平本，控制数量\n- **爆款/主推款** —— 走量核心，占销售额 50% 以上\n- **利润款** —— 赚钱主力\n- **形象款** —— 拉高客单价与直播间调性\n\n### 核心指标诊断\n| 指标 | 说明 | 偏低时的动作 |\n|------|------|------------|\n| 平均停留时长 | 低于 30 秒说明开场有问题 | 改开场话术、加福利钩子 |\n| UV 价值 | 成交额 ÷ 观看人数 | 提高转化或客单价 |\n| 转化率 | 成交人数 ÷ 观看人数 | 优化讲解与逼单话术 |\n| 互动率 | 评论点赞 ÷ 观看 | 增加互动引导与抽奖 |\n\n---\n\n## 六、评价与口碑运营\n\n评价是转化率的**决定性因素之一**，尤其是前 10 条。\n\n### 实操要点\n- **首批评价至关重要**，必须确保真实优质，带图带视频\n- 主动引导评价：包裹卡（不得以好评返现诱导，平台明令禁止）、\n  售后回访、会员积分\n- **差评必须第一时间响应**，公开回复要克制专业，\n  展现解决问题的态度——回复是给后来的潜在买家看的\n- **定期分析差评关键词**，这是产品迭代最真实的输入源\n- 「问大家」板块同样影响转化，需要主动维护\n\n### 合规红线\n- **好评返现属于违规行为**，平台会处罚，且涉嫌违反《反不正当竞争法》\n- **刷单炒信违法**，情节严重可构成犯罪\n- 不得**删除或屏蔽真实差评**\n\n---\n\n## 七、发布前检查清单\n\n每一条对外内容发布前，逐项确认：\n\n- [ ] 已运行 `python scripts/compliance.py --file 文案.txt`，无 P0 命中\n- [ ] 标题字数未超限，核心词完整可切分\n- [ ] 后台属性与标题、详情页描述完全一致\n- [ ] 主图无违规文字占比，无第三方品牌/水印\n- [ ] 价格与优惠券逻辑正确，划线价为真实成交价\n- [ ] 所有宣称的功效/资质均有对应证明文件\n- [ ] 促销时间与库存真实可兑现\n- [ ] 无站外引流信息（小红书、抖音尤其严格）\n\nFile v1.2.0:references/operations-playbook.md\n\n# 日常运营、数据体系与风控手册\n\n---\n\n## 一、GMV 公式拆解：所有运营动作的起点\n\n```\nGMV = 曝光量 × 点击率 × 转化率 × 客单价\n    = 访客数(UV) × 转化率 × 客单价\n    = 访客数 × UV 价值\n```\n\n**任何提升 GMV 的动作，必然落在这四个变量之一上。**\n说不清自己在优化哪个变量的运营动作，都是无效动作。\n\n| 变量 | 提升手段 | 见 |\n|------|---------|-----|\n| 曝光量 | 关键词覆盖、付费投放、活动坑位、内容分发 | platform-playbook.md |\n| 点击率 | 主图、标题、价格带、人群精准度 | listing-and-content.md |\n| 转化率 | 详情页、评价、价格力、信任状、客服 | listing-and-content.md |\n| 客单价 | 套餐搭配、满减凑单、关联推荐、升级款 | 本文第四节 |\n\n**诊断顺序**：先用 `scripts/diagnose.py` 找出最短板的环节，\n再针对性投入。四个变量都及格时，才应该加大流量投入。\n\n---\n\n## 二、核心指标定义与健康区间\n\n### 流量与转化\n| 指标 | 计算方式 | 说明 |\n|------|---------|------|\n| UV | 独立访客数 | 流量规模 |\n| 点击率 CTR | 点击 ÷ 曝光 | 主图与标题的吸引力 |\n| 转化率 CVR | 支付人数 ÷ 访客数 | 承接能力 |\n| UV 价值 | 支付金额 ÷ 访客数 | 单个流量的产值，投放的核心依据 |\n| 客单价 | 支付金额 ÷ 支付人数 | 单笔订单规模 |\n| 加购收藏率 | 加购收藏 ÷ 访客 | 潜在需求，预示后续转化 |\n\n### 投放效率\n| 指标 | 计算方式 | 说明 |\n|------|---------|------|\n| ROI / ROAS | 成交金额 ÷ 广告花费 | 投产比 |\n| 保本 ROI | 1 ÷ 毛利率 | 低于此值必亏，用 `ad_calc.py` 算 |\n| CPC | 花费 ÷ 点击 | 点击单价 |\n| CPA | 花费 ÷ 成交单数 | 获客成本 |\n| GPM | 成交额 ÷ 曝光 × 1000 | 抖音核心指标 |\n\n### 服务与健康度\n| 指标 | 健康区间（经验值） | 影响 |\n|------|-----------------|------|\n| DSR 动态评分 | ≥ 4.8 | 低于均值影响搜索权重 |\n| 退款率 | 低于行业均值 | 超标直接降权 |\n| 退款自主完结时长 | 越短越好 | 影响服务分 |\n| 发货时效 | 24–48 小时内 | 超时罚款且降权 |\n| 客服响应时长 | < 30 秒 | 影响转化与服务分 |\n| 纠纷率 | 越低越好 | 严重时限制活动报名 |\n\n**重要**：各平台的服务分（抖音体验分、拼多多服务分、天猫 DSR）\n直接决定能否报名活动、能否获得流量扶持，是运营的生命线。\n\n---\n\n## 三、运营节奏\n\n### 每日必做（30 分钟）\n1. 看昨日核心数据：GMV、UV、转化率、ROI，与前一日/上周同期对比\n2. 检查异常：流量突降、转化突降、差评、退款激增\n3. 处理待发货订单，确保不超时\n4. 回复所有评价与「问大家」\n5. 检查广告计划消耗与 ROI，暂停明显亏损的计划\n\n### 每周必做\n1. 拉取周数据，做转化漏斗诊断（`diagnose.py`）\n2. 关键词报表分析：加词、删词、调价\n3. 竞品监控：价格、活动、新品、主图变化\n4. 库存盘点，触发补货\n5. 复盘本周投放，输出下周计划\n\n### 每月必做\n1. 全店产品结构复盘：引流/利润/形象/狙击款的贡献占比\n2. 利润核算（`pricing.py` 实算，不看毛估）\n3. 差评关键词聚类，输出产品改进需求\n4. 下月活动排期与备货计划\n\n---\n\n## 四、提升客单价的六种手段\n\n1. **满减凑单** —— 门槛设在客单价的 1.5 倍左右最有效\n2. **套餐组合** —— 主品 + 配件打包，比单卖利润更高\n3. **多规格阶梯定价** —— 买 2 件更划算，直接拉高件单价\n4. **关联推荐** —— 详情页底部与购物车页推荐互补品\n5. **升级款引导** —— 用价格锚点让中间档看起来最划算\n6. **赠品换购** —— 加 X 元换购高感知价值商品\n\n**注意**：提升客单价往往会降低转化率，\n需用 `ad_calc.py` 验证 UV 价值（客单价 × 转化率）是否净提升。\n\n---\n\n## 五、大促节奏（以双 11 / 618 为例）\n\n| 阶段 | 时间 | 核心动作 |\n|------|------|---------|\n| 预热蓄水 | 提前 30–45 天 | 上新、内容种草、拉新加购收藏 |\n| 加购蓄水 | 提前 10–15 天 | 定金预售、优惠券发放、直播预告 |\n| 爆发期 | 大促当日 | 全力投放、直播续场、客服全员待命 |\n| 返场期 | 后 3–7 天 | 承接犹豫用户，清理尾货 |\n| 复盘期 | 后 7–15 天 | 数据复盘、退货处理、库存消化 |\n\n**易踩的坑**：\n- **备货不足**：爆单后断货，权重与口碑双杀\n- **备货过量**：大促后长期库存积压，现金流枯竭\n- **价格穿底**：为冲量把价格打到亏损，大促后无法恢复原价\n- **客服崩盘**：响应超时导致服务分下降，影响后续流量\n- **物流爆仓**：预留发货缓冲，提前与快递协商产能\n\n---\n\n## 六、售后与客服\n\n### 降低退货率的实操手段\n1. **前置预期管理** —— 详情页把尺码、色差、材质说清楚，\n   宁可少卖也不要卖错。预期落差是退货第一原因。\n2. **尺码表要给真实数据** —— 服饰类提供模特身高体重与穿着尺码\n3. **主动售后** —— 发货后主动推送物流，签收后回访\n4. **退货原因分析** —— 每月聚类分析，反推产品与文案问题\n\n### 差评处理原则\n- **第一时间响应**，24 小时内\n- 公开回复是**写给潜在买家看的**，不是写给差评者看的：\n  克制、专业、给出解决方案，不辩解不对骂\n- 私下联系解决实际问题，能挽回则挽回\n- **不得删除或屏蔽真实差评**，也不得骚扰要求修改评价\n\n---\n\n## 七、风控红线（触碰即重罚）\n\n### 平台层面\n| 违规行为 | 后果 |\n|---------|------|\n| 刷单炒信 | 扣分、降权、清退，情节严重构成犯罪 |\n| 虚假发货 | 高额罚款 + 降权 |\n| 延迟发货 | 按单赔付 + 服务分下降 |\n| 售假/侵权 | 商品下架、扣分、店铺关闭、保证金扣除 |\n| 盗用他人图片 | 侵权投诉、删除链接、赔偿 |\n| 描述不符 | 退款率上升 + 平台处罚 |\n| 站外引流 | 小红书/抖音尤其严格，限流至封号 |\n| 好评返现 | 违规且涉嫌违反《反不正当竞争法》 |\n\n### 法律层面\n- **《广告法》第九条** —— 绝对化用语，罚款起点二十万元。\n  所有文案发布前必须过 `scripts/compliance.py`。\n- **《消费者权益保护法》** —— 七天无理由退货义务\n- **《电子商务法》** —— 平台内经营者需公示营业执照、依法纳税\n- **《反不正当竞争法》** —— 禁止虚假宣传、刷单、诋毁竞争对手\n- **《价格法》** —— 禁止虚构原价、虚假优惠折价\n\n### 自查频率建议\n- 每次上新：合规扫描 + 资质核对\n- 每周：抽查在售商品文案\n- 每月：全店文案批量扫描（`compliance.py --file`）\n- 平台规则更新时：立即全店自查\n\n---\n\n## 八、常见问题速查\n\n**Q：流量突然下降怎么办？**\n按顺序排查：① 是否有违规扣分 ② 关键词排名是否掉了\n③ 竞品是否有大动作 ④ 是否是类目大盘下滑（看行业数据）\n⑤ 主图/标题/价格是否被改动 ⑥ 广告计划是否被暂停或预算耗尽。\n\n**Q：有流量没转化？**\n用 `diagnose.py` 定位具体环节。常见原因：流量不精准（人群标签乱了）、\n价格无竞争力、评价有硬伤、详情页说服力不足。\n\n**Q：ROI 一直做不上去？**\n用 `ad_calc.py` 先算保本 ROI。若当前 ROI 低于保本值，\n优先级是：提转化率 > 降 CPC > 提客单价。\n盲目加预算只会放大亏损。\n\n**Q：要不要做低价冲量？**\n先算账。低价冲量会打乱人群标签、拉低客单价心智，\n且平台比价机制会记录历史低价。除非有明确的冲层级/冲活动目标，\n否则不建议。用 `pricing.py` 算出保本售价，绝不低于此价。\n\nFile v1.2.0:references/platform-playbook.md\n\n# 国内六大电商平台流量机制与打法\n\n> 说明：本文为运营实操经验总结。平台算法与规则持续迭代，具体权重口径以\n> 各平台商家后台官方文档、规则中心公示为准。文中标注「经验值」的部分为\n> 行业普遍认知，非平台官方公布数据。\n\n---\n\n## 一、机制差异总览\n\n不同平台的底层逻辑决定了打法完全不同，照搬必死。\n\n| 平台 | 流量本质 | 用户心智 | 决定性指标 | 起量关键 |\n|------|---------|---------|-----------|---------|\n| 淘宝/天猫 | 搜索为主 + 推荐 | 有明确需求，货比三家 | 单坑产出（坑产） | 关键词卡位 + 人群标签 |\n| 京东 | 搜索为主 | 品质与时效优先 | 转化率 + 客单价 | 类目排名 + 物流时效 |\n| 拼多多 | 推荐为主 | 价格敏感，冲动下单 | 价格力 + 销量 | 活动坑位 + 低价冲量 |\n| 抖音 | 内容推荐 | 无明确需求，被激发 | GPM（千次观看成交额） | 内容点击率 + 转化效率 |\n| 小红书 | 内容搜索 + 推荐 | 决策前查攻略 | 笔记互动率 | 关键词种草 + 口碑沉淀 |\n| 视频号/微信小店 | 社交推荐 + 私域 | 信任驱动 | 复购率 | 私域沉淀 + 社交裂变 |\n\n**核心判断**：需求明确的标品去淘宝/京东/拼多多，需求需要被创造的\n非标品、新奇特产品去抖音/小红书。\n\n---\n\n## 二、淘宝 / 天猫\n\n### 搜索排序的权重构成（经验值）\n优先级从高到低：\n\n1. **类目相关性** —— 类目放错，后面全白搭。这是一票否决项。\n2. **文本相关性** —— 标题关键词与搜索词的匹配度\n3. **商品权重** —— 单坑产出（该关键词下的支付金额）、转化率、收藏加购率\n4. **店铺权重** —— 店铺层级、DSR 评分、退款率、纠纷率\n5. **个性化标签** —— 商品人群标签与搜索用户标签的匹配度\n\n**「坑产」是淘宝搜索的核心**：同一个关键词下，谁的支付金额高，谁排前面。\n所以刷低价单破坏的不只是转化率，更是把人群标签打乱。\n\n### 店铺层级\n按近 30 天支付金额分为 7 层。**跨层是流量分水岭**，同层商家互相竞争。\n卡在层级边缘时，冲一把跨层的收益远大于日常优化。\n\n### 标题规范\n- 天猫/淘宝标题上限 **30 个汉字（60 字符）**\n- 结构：`营销词 + 品牌词 + 核心词 + 属性词 + 长尾词`\n- 核心词必须放在能被完整切分的位置，避免关键词被拆散\n- 不留空格可提高字符利用率，但要保证可读性\n- 新品期用**精准长尾词**，有基础销量后再抢大词\n\n### 新品冷启动路径\n1. **0–7 天**：上架后打标（新品标），完善所有属性，主图/详情页做足\n2. **7–14 天**：用精准长尾词做基础销量 5–10 单 + 真实评价 + 买家秀\n3. **14–30 天**：直通车测图测款，跑出点击率高于行业均值的主图\n4. **30 天后**：有数据基础后放大投放，逐步抢中大词\n\n### 付费工具\n- **直通车（标准推广）** —— 关键词竞价，控词控人群，测款测图首选\n- **引力魔方** —— 人群定向，拉新与收割，适合推荐流量\n- **万相台无界** —— 智能化投放，托管出价，适合缺乏投放经验的商家\n\n---\n\n## 三、拼多多\n\n### 核心逻辑\n拼多多是**推荐流量为主**的平台，首页推荐占比远高于搜索。\n用户决策路径极短，价格力是第一位的。\n\n### 权重构成（经验值）\n`销量 + 转化率 + 价格力 + 服务分（DSR/发货时效/纠纷率）`\n\n**价格力**：平台会拿你的商品与全网同款比价，价格无优势直接失去推荐流量。\n\n### 起量路径\n1. 新品上架，先用**低价 + 低毛利**冲基础销量与评价\n2. 报名平台活动坑位：**限时秒杀、9块9特卖、百亿补贴**\n3. 活动带来的爆发销量会反哺自然推荐流量\n4. 有权重后再逐步调价，或用高毛利款承接流量\n\n### 推广工具\n- **搜索推广** —— 关键词竞价，意图明确\n- **场景推广** —— 推荐位竞价，走量核心\n- **明星店铺 / 全站推广** —— 智能投放\n\n**注意**：拼多多对**发货时效与售后**极其严格，延迟发货、虚假发货罚款重，\n\"仅退款\"政策对商家不友好，选品要充分考虑退货与纠纷成本。\n\n---\n\n## 四、抖音电商（兴趣电商）\n\n### 流量机制：赛马制\n内容发布后进入初始流量池（经验值约 300–500 曝光），\n系统根据数据表现决定是否推入下一级流量池。**层层赛马，逐级放大**。\n\n因此**前 500 次曝光的数据表现决定了这条内容的生死**。\n\n### 最核心指标：GPM\n```\nGPM = 成交金额 ÷ 曝光人数 × 1000\n```\n即\"每一千次观看能产生多少成交额\"。抖音判断是否给你更多流量，\n本质就是看你的流量变现效率，GPM 越高，系统越愿意给量。\n\n**提升 GPM 只有三条路**：提高点击率、提高转化率、提高客单价。\n\n### 短视频带货关键指标\n| 指标 | 参考基准（经验值） | 影响 |\n|------|-----------------|------|\n| 3 秒完播率 | > 45% | 决定是否继续推流 |\n| 完播率 | > 15% | 内容质量核心信号 |\n| 点击率（视频→商品） | > 3% | 挂车吸引力 |\n| 转化率 | > 3% | 商品详情承接力 |\n\n**黄金 3 秒**：前 3 秒必须给出冲突、痛点或结果，否则直接划走。\n\n### 直播间核心指标\n- **停留时长** —— 低于 30 秒说明开场话术或货品有问题\n- **互动率** —— 评论、点赞、加粉，影响推流\n- **UV 价值** = 成交额 ÷ 观看人数，直播间的\"坑产\"\n- **转化率** —— 场观到成交\n\n**直播节奏**：憋单引流 → 讲解产品 → 逼单成交 → 循环。\n每个循环 15–25 分钟，福利款引流、利润款赚钱、形象款拉高客单。\n\n### 付费工具：巨量千川\n- **随心推** —— 简易版，适合小额加热内容\n- **专业版-控成本投放** —— 设定成交出价，系统控制 CPA，稳定但量少\n- **专业版-放量投放** —— 不控成本，冲量用，风险高\n- **常见打法**：先用小额测素材，跑出高 CTR 素材后再放大投放\n\n### 达人分销\n通过**精选联盟**挂佣金，招募达人带货。\n佣金率通常设置在 **10%–30%**（另需支付平台技术服务费）。\n高佣金能吸引达人，但要先用 pricing.py 算清楚是否还有利润空间。\n\n---\n\n## 五、京东\n\n### 特点\n- 用户**购买意图明确**，客单价与转化率普遍高于其他平台\n- **物流时效是核心竞争力**，使用京东物流对搜索权重和转化都有正向影响\n- 3C 数码、家电品类优势明显\n\n### POP 店铺权重\n`销量 + 转化率 + 好评率 + 店铺星级（店铺评分）+ 物流时效`\n\n### 推广工具：京准通\n- **快车** —— 关键词竞价，等同直通车\n- **京东直投 / 购物触点** —— 站内展示位\n- **京挑客** —— 达人分销\n\n**注意**：京东有平台使用费和类目扣点，POP 店铺还有保证金要求，\n入驻门槛高于淘宝，但客单价与利润空间通常更好。\n\n---\n\n## 六、小红书\n\n### 平台本质\n**决策前的攻略平台**。用户在这里\"查作业\"，然后可能在小红书买，\n也可能去淘宝/天猫下单。所以小红书的价值不只是 GMV，更是**心智种草**。\n\n### 笔记权重：CES 评分（业内经验公式，官方未公开）\n```\nCES = 点赞×1 + 收藏×1 + 评论×4 + 转发×4 + 关注×8\n```\n**收藏与评论的价值远高于点赞**，因为它们代表\"真实有用\"。\n所以笔记结尾引导收藏（\"先码住\"）比引导点赞更有效。\n\n### 内容策略\n- 标题必须带**核心搜索关键词**，小红书搜索流量占比高\n- 正文自然植入关键词 3–5 次，结尾带 3–5 个精准话题标签\n- 封面图是点击率的决定因素，竖版 3:4，文字信息清晰\n- **真实感 > 精致感**，过度商业化的内容会被限流\n\n### 合规红线\n- 商业笔记必须通过**蒲公英平台**报备，否则会被判违规限流\n- 严禁**站外引流**（留微信、淘口令），轻则限流重则封号\n- 医美、保健品等类目有严格的内容限制\n\n### 变现路径\n1. 笔记种草 → 小红书商城闭环成交\n2. 笔记种草 → 用户去其他平台搜索品牌词下单（需做好品牌词承接）\n3. 买手直播带货\n\n---\n\n## 七、视频号 / 微信小店\n\n### 核心价值\n**社交推荐 + 私域沉淀**。依托微信生态，信任成本低，复购率高。\n\n### 打法\n- 公域：视频号内容推荐、直播广场\n- 私域：社群、朋友圈、公众号导流至小店\n- **社交裂变**：拼团、分享有礼在微信生态天然适配\n\n适合**高复购、需要信任背书**的品类（食品、母婴、健康、知识付费）。\n\n---\n\n## 八、跨平台通用铁律\n\n1. **不要照搬打法**。抖音的爆款视频思路搬到淘宝详情页会水土不服。\n2. **先算账再投流**。任何投放前先用 `pricing.py` 与 `ad_calc.py`\n   算出保本 ROI 与最高可承受 CPC，没有这两个数字就是在盲投。\n3. **人群标签一旦打乱，恢复成本极高**。低价冲量、非目标人群引流\n   会污染标签，导致后续精准流量失效。\n4. **合规先于增长**。所有对外文案先过 `compliance.py`，\n   广告法罚则起点二十万，一次翻车抵掉全年利润。\n5. **数据诊断优先于加预算**。转化链路有短板时加预算等于放大亏损，\n   先用 `diagnose.py` 定位瓶颈。\n\nFile v1.2.0:references/product-selection.md\n\n# 选品方法论与决策框架\n\n> 选品决定了 70% 的结果。运营能力只能放大选品的正确性，无法逆转错误的选品。\n\n---\n\n## 一、选品的四道门槛（顺序不可颠倒）\n\n任何一款产品，必须按顺序通过以下四关，前一关不过直接淘汰，不要留恋。\n\n### 第一关：合规关（一票否决）\n先确认能不能卖，再谈赚不赚钱。\n\n| 品类 | 强制要求 |\n|------|---------|\n| 3C 电子、儿童玩具、电器 | CCC 强制认证 |\n| 食品 | 食品经营许可证、SC 生产许可 |\n| 化妆品 | 化妆品备案凭证；美白/祛斑需「国妆特字」批文 |\n| 保健食品 | 蓝帽子批准文号 |\n| 医疗器械 | 一/二/三类医疗器械经营备案或许可 |\n| 图书音像 | 出版物经营许可证 |\n| 品牌商品 | 品牌授权书（缺失即侵权下架） |\n\n**知识产权排查**：外观专利、实用新型专利、商标、著作权。\n跨境或新奇特产品尤其容易踩专利雷，一封投诉信可能导致全店冻结。\n\n### 第二关：利润关\n用 `scripts/pricing.py` 实算，不要凭感觉。\n\n**判断标准（经验值）**：\n- 毛利率 **< 40%** —— 无法承担付费流量，只能靠自然流量，慎入\n- 毛利率 **40%–60%** —— 可做，但投放空间紧张，需精细化运营\n- 毛利率 **> 60%** —— 有充足投放空间，可以打爆款\n\n**必须算进去但最容易被忽略的成本**：\n去程运费、退货回程运费、包材、平台佣金、支付手续费、\n推广费、客服人力分摊、仓储分摊、坏账与损耗。\n\n### 第三关：需求关\n判断这个东西**到底有没有人要**。\n\n- **搜索型平台（淘宝/京东/拼多多）**：看关键词搜索指数与趋势。\n  搜索量持续下滑的品类不要进，那是在接盘。\n- **推荐型平台（抖音/小红书）**：看话题热度、同类内容互动量。\n  已经有内容跑出爆款说明需求被验证，完全没有内容的要警惕是伪需求。\n- **季节性判断**：提前 45–60 天布局。夏季品五月才上架已经晚了。\n\n### 第四关：竞争关\n```\n供需比 = 关键词搜索人气 ÷ 在售商品数\n```\n供需比越高说明需求大而供给少，机会越大。\n\n**竞争格局判断**：\n- 头部（TOP10）占据 80% 以上份额 → 垄断市场，新手勿入\n- 头部分散，长尾商家有销量 → 有机会切入\n- 全是白牌低价厮杀 → 除非有供应链成本优势，否则不进\n\n---\n\n## 二、选品评分模型\n\n用 `scripts/product_score.py` 量化打分，避免拍脑袋决策。\n六个维度，加权总分 100 分：\n\n| 维度 | 权重 | 评分要点 |\n|------|-----|---------|\n| 利润空间 | 25% | 毛利率高低，是否支撑投放 |\n| 市场需求 | 20% | 搜索量/内容热度及趋势方向 |\n| 竞争强度 | 20% | 供需比、头部集中度 |\n| 退货风险 | 15% | 品类退货率、尺码/色差问题 |\n| 物流成本 | 10% | 重量体积、易碎性、发货难度 |\n| 供应链 | 10% | 起订量、翻单速度、账期 |\n\n**决策阈值（经验值）**：\n- **≥ 75 分** —— 优质款，可重点投入资源打造\n- **60–74 分** —— 可做款，小批量测试后再决定\n- **< 60 分** —— 放弃，机会成本太高\n\n---\n\n## 三、按退货率划分的品类风险\n\n退货率是国内电商最容易被低估的利润杀手，尤其在抖音等冲动消费场景。\n\n| 品类 | 退货率参考区间（经验值） | 主要原因 |\n|------|----------------------|---------|\n| 服饰鞋帽 | 30%–50%（直播可达 60%+） | 尺码、色差、版型预期落差 |\n| 美妆护肤 | 10%–20% | 肤感不符、过敏 |\n| 3C 数码 | 5%–15% | 参数不符、质量问题 |\n| 家居日用 | 10%–20% | 尺寸不符、材质预期 |\n| 食品生鲜 | 5%–15% | 物流损耗、口味 |\n| 图书文具 | 3%–8% | 相对最低 |\n\n**关键**：服饰类在抖音直播场景退货率可能超过 50%，\n用 `pricing.py --return-rate 50` 算一下，很多\"爆单\"其实是巨亏。\n\n---\n\n## 四、产品结构：四种角色缺一不可\n\n单靠一款产品无法支撑店铺，必须搭建产品矩阵。\n\n1. **引流款**（占比 20%）\n   低价高需求，用于获取流量与新客，毛利可接近于零，甚至微亏。\n   考核指标是**引流效率**（UV 成本），不是利润。\n\n2. **利润款**（占比 30%）\n   店铺的现金流来源，毛利率 60% 以上，靠引流款带来的流量承接转化。\n   考核指标是**利润额**。\n\n3. **形象款**（占比 10%）\n   高客单、高品质，拉高店铺整体调性与客单价，销量不高但不可缺。\n   考核指标是**客单价拉升**。\n\n4. **狙击款**（占比 40%）\n   对标竞品的同款或改良款，用于抢占竞品流量，价格与卖点针对性设计。\n   考核指标是**市场份额**。\n\n---\n\n## 五、供应链与备货\n\n### 供应商评估要点\n- **起订量（MOQ）** —— 首单不要压太多货，测款期用小单快反\n- **翻单速度** —— 爆款出现后能否 7 天内补货，这决定能否吃到红利\n- **账期** —— 现结还是月结，直接影响资金周转\n- **质检能力** —— 次品率高会推高退货率，摧毁店铺权重\n- **是否支持一件代发** —— 起步期降低库存风险\n\n### 备货公式\n```\n安全库存 = 日均销量 × 补货周期天数 × (1 + 安全系数)\n建议备货量 = 预估日销 × 备货天数 - 现有库存 - 在途库存\n```\n安全系数一般取 **0.2–0.5**，大促期间取上限。\n\n**备货铁律**：\n- 新品测试期：只备**7–15 天**销量，宁可断货也不要压死资金\n- 稳定期：备**20–30 天**销量\n- 大促前：按预估峰值备货，但要留好尾货处理方案\n- **季节性商品必须在季末前清空**，压到下一年的库存基本等于亏损\n\n---\n\n## 六、常见选品陷阱\n\n1. **自嗨式选品** —— \"我觉得这个好\"。市场数据才是唯一依据。\n2. **只看销量不看利润** —— 卖爆了却在亏钱，是最常见的死法。\n3. **忽略退货率** —— 服饰类尤其致命，退货率算错一切归零。\n4. **忽略专利与授权** —— 尤其是新奇特产品与品牌周边。\n5. **盲目跟风爆款** —— 你看到爆款时，红利期通常已过，\n   且价格战已经开始，此时入场是接盘。\n6. **供应链没谈好就推爆款** —— 推爆了补不上货，权重掉光，得不偿失。\n\nFile v1.2.0:skill-card.md\n\n## Description:\n\ncn-ecommerce-ops helps agents support China-focused ecommerce operations with calculators and playbooks for product selection, pricing, ad ROI, conversion funnel diagnosis, compliance checks, title generation, inventory planning, and real-time data handoff.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[g305595965](https://clawhub.ai/user/g305595965)\n\n### License/Terms of Use:\n\nMIT\n\n## Use Case:\n\nExternal merchants, ecommerce operators, and agent developers use this skill to evaluate products, compute margins and advertising break-even points, diagnose store conversion funnels, generate listing content, check advertising-law wording risk, and plan inventory for Chinese marketplace and Temu workflows.\n\n### Deployment Geography for Use:\n\nChina-focused ecommerce operations, with cross-border Temu use cases where applicable.\n\n## Known Risks and Mitigations:\n\nRisk: The live-data planner can turn values from live_data.json into copy-executable shell command strings without quoting or validation.\n\nMitigation: Keep live_data.json under user control, validate or shell-quote command arguments before execution, and prefer running calculators manually with known-good values.\n\nRisk: Current marketplace inputs and live FX data can affect recommendations if the agent uses unintended or untrusted sources.\n\nMitigation: Allow network access only for disclosed marketplace data sources that the user intends to use, and verify final rates against merchant backends before acting.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/g305595965/skills/cn-ecommerce-ops)\n- [Publisher profile: g305595965](https://clawhub.ai/user/g305595965)\n- [Product selection methodology](references/product-selection.md)\n- [Platform playbook](references/platform-playbook.md)\n- [Listing and content guide](references/listing-and-content.md)\n- [Operations and risk-control playbook](references/operations-playbook.md)\n- [Temu cross-border playbook](references/crossborder-temu.md)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown guidance with Python command snippets and optional JSON calculator outputs]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Calculator scripts support --json output; live.py plan can produce command strings from live_data.json for downstream review or execution.]\n\n## Skill Version(s):\n\n1.2.0 (source: frontmatter, release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.2.0:examples/realtime_demo_保温杯_douyin.json\n\n{\n  \"meta\": {\n    \"keyword\": \"316不锈钢保温杯(500ml)\",\n    \"platform\": \"douyin\",\n    \"as_of\": \"2026-08-15\",\n    \"note\": \"实时数据来源: 抖音厨具佣金率取自抖店规则中心2026资费标准+九大扶持政策(常规2%-5%,厨具免佣可至0.6%); 进货价取自1688/义乌购316保温杯实时批发页(¥12-15); 退货率取饮具类6.7%-12%中值; 热度/趋势取自1688夏季爆款榜(趋势向上). 搜索量/供需比为估算proxy,请于巨量算数/生意参谋核实.\"\n  },\n  \"cost\": 12.0,\n  \"price\": 49.9,\n  \"commission\": 2.0,\n  \"shipping\": 3.0,\n  \"packaging\": 1.5,\n  \"return_rate\": 10.0,\n  \"ad_ratio\": 18.0,\n  \"search_index\": 120000,\n  \"trend\": \"up\",\n  \"supply_ratio\": 3.0,\n  \"weight_kg\": 0.4,\n  \"fragile\": false,\n  \"moq\": 10,\n  \"restock_days\": 3,\n  \"cvr\": 2.5,\n  \"cpc\": 1.5\n}\n\nFile v1.2.0:LICENSE\n\nMIT License\n\nCopyright (c) 2026 g305595965\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\nArchive v1.0.2: 26 files, 2775867 bytes\n\nFiles: .gitattributes (253b), .gitignore (249b), assets (0b), assets/demo.gif (2923122b), examples (0b), examples/realtime_demo_保温杯_douyin.json (807b), LICENSE (1067b), README.md (8415b), references (0b), references/listing-and-content.md (7524b), references/operations-playbook.md (7991b), references/platform-playbook.md (9588b), references/product-selection.md (6444b), scripts (0b), scripts/ad_calc.py (11720b), scripts/compliance.py (15008b), scripts/diagnose.py (12096b), scripts/live.py (21955b), scripts/platform_fees.py (4678b), scripts/pricing.py (13642b), scripts/product_score.py (13926b), skill-card.md (2808b), SKILL.md (14024b), tests (0b), tests/run_all.py (11113b), _meta.json (135b)\n\nFile v1.0.2:SKILL.md\n\n---\nname: cn-ecommerce-ops\nversion: 1.1.0\ndescription: 国内电商全链路运营专家技能，覆盖淘宝、天猫、京东、拼多多、抖音电商、小红书、视频号六大平台。提供选品评分、定价与利润测算、广告投放ROI测算、店铺转化漏斗诊断、广告法违禁词合规检查五个可计算工具，以及一个实时数据桥接器(live.py)——先用 WebSearch/WebFetch 拉取当前真实佣金率、类目退货率、1688进货价、关键词搜索量，再一键灌入各计算器，实现\"实时可用\"的决策。当用户涉及国内电商选品、定价、算利润、算ROI、投直通车或千川、做店铺诊断、优化标题主图详情页、写商品文案、直播运营、检查文案是否违反广告法、平台规则与流量玩法，或需要查最新费率/获取实时行情来辅助决策时，应使用本技能。\nauthor: g305595965\nrepository: https://github.com/g305595965/cn-ecommerce-ops\nlicense: MIT\ntags:\n  - 电商\n  - 国内电商\n  - 淘宝\n  - 天猫\n  - 京东\n  - 拼多多\n  - 抖音电商\n  - 小红书\n  - 视频号\n  - 选品\n  - 定价\n  - 利润\n  - ROI\n  - 广告投放\n  - 漏斗诊断\n  - 广告法\n  - 合规\ntriggers:\n  - 国内电商\n  - 电商运营\n  - 定价测算\n  - 利润计算\n  - 保本价\n  - 广告ROI\n  - 投放ROI\n  - 转化漏斗\n  - 漏斗诊断\n  - 选品评分\n  - 广告法违禁词\n  - 极限词检查\n  - 淘宝运营\n  - 抖音电商\n  - 小红书运营\n  - 实时费率\n  - 实时行情\n  - 查最新佣金\n  - 1688进货价\n  - 关键词搜索量\n  - 数据以实时为准\nagent_created: true\n---\n\n# 国内电商全链路运营\n\n## 概述\n\n本技能把国内电商运营中最依赖经验判断的环节，转化为可计算、可复核的\n决策流程。核心主张是：**先算账，再做事**。\n\n多数电商决策失误源于三件事——不算真实利润（漏算退货与推广成本）、\n不算保本 ROI（盲目投放）、不查合规（广告法罚则起点二十万元）。\n本技能为这三件事各提供了确定性工具。\n\n## 何时使用\n\n在遇到以下任一场景时使用本技能：\n\n- 判断某款产品值不值得做（选品评估、竞品分析）\n- 定价、核算真实利润、计算保本售价\n- 投放前测算保本 ROI、可承受最高出价、目标 ROI 反推\n- 店铺流量正常但不出单、转化率下滑、ROI 做不上去\n- 撰写或审核商品标题、主图文案、详情页、短视频脚本、直播话术\n- 检查文案是否触碰广告法违禁词与极限词\n- 了解淘宝/天猫/京东/拼多多/抖音/小红书的流量机制与冷启动打法\n- 制定日常运营节奏、大促排期、备货计划\n\n## 快速路由\n\n根据用户问题类型，选择对应工具或文档：\n\n| 用户问题类型 | 使用 |\n|------------|------|\n| 这个品能不能做 | `scripts/product_score.py` + `references/product-selection.md` |\n| 卖多少钱／能赚多少／保本价 | `scripts/pricing.py` |\n| 广告怎么投／ROI 多少才不亏／出价多少 | `scripts/ad_calc.py` |\n| 有流量不出单／哪个环节有问题 | `scripts/diagnose.py` |\n| 文案能不能这么写／会不会违规 | `scripts/compliance.py` |\n| 给我实时费率/进货价/搜索量再算 | `scripts/live.py`（先 `sources`/`schema` 拉数据，再 `plan` 灌入计算器） |\n| 平台怎么起量／算法逻辑 | `references/platform-playbook.md` |\n| 标题主图详情页／短视频／直播 | `references/listing-and-content.md` |\n| 日常怎么做／大促怎么排／怎么防违规 | `references/operations-playbook.md` |\n\n## 可执行工具\n\n全部脚本使用 Python 3 标准库，无第三方依赖，可直接运行。\n所有脚本均支持 `--json` 输出结构化结果，支持 `--self-test` 自检。\n运行前先切换到 `scripts/` 目录，或确保该目录在 `PYTHONPATH` 中。\n\n### 1. 定价与利润测算 —— pricing.py\n\n采用 100 单基准法核算，把退货造成的去程运费、包材、损耗全部计入，\n这是\"卖爆了却在亏钱\"的根本原因。\n\n```bash\npython scripts/pricing.py --cost 35 --price 129 --platform douyin \\\n    --shipping 4.5 --packaging 1.5 --return-rate 30 --ad-ratio 18\n```\n\n输出单均净利、净利率、毛利率、**保本售价**、**保本 ROI** 与成本结构。\n`--list-platforms` 查看内置平台费率参考表。\n\n**关键用法**：在任何定价、报价、谈达人佣金、参加活动前先跑一次。\n得到的\"保本售价\"是价格底线，\"保本 ROI\"是投放的生死线。\n\n### 2. 投放测算 —— ad_calc.py\n\n适用于直通车、万相台、巨量千川、京准通、多多推广等所有 CPC 场景。\n\n```bash\npython scripts/ad_calc.py --price 129 --gross-margin 60 --cvr 2.5 --cpc 1.2 \\\n    --budget 2000 --target-roi 4\n```\n\n输出 UV 价值、当前 ROI、保本 ROI、**可承受最高 CPC**、CPA、\n日预算测算，以及达成目标 ROI 所需的 CPC 或转化率（二选一路径）。\n\n**核心恒等式**：`ROI = UV价值 ÷ CPC`，`保本ROI = 1 ÷ 毛利率`。\n毛利率参数应使用 `pricing.py` 算出的毛利率，两个工具串联使用。\n\n### 3. 转化漏斗诊断 —— diagnose.py\n\n不看哪个数字低，而是看**哪个环节相对行业基准差得最多**，\n偏离最大的环节即为瓶颈，优先修复它的投入产出比最高。\n\n```bash\npython scripts/diagnose.py --impression 200000 --click 2000 --cart 200 \\\n    --order 110 --paid 55 --refund 8 --gmv 6600\n```\n\n输出各环节转化率与基准对比、瓶颈定位、按优先级排序的处方，\n以及\"瓶颈修复到基准后订单能涨多少\"的提升模拟。\n\n**使用原则**：转化链路存在短板时加预算等于放大亏损，先诊断再投放。\n\n### 4. 选品六维评分 —— product_score.py\n\n利润空间 25%、市场需求 20%、竞争强度 20%、退货风险 15%、\n物流成本 10%、供应链 10%，加权总分 100。\n\n```bash\npython scripts/product_score.py --gross-margin 62 --search-index 8000 \\\n    --trend up --supply-ratio 3.2 --return-rate 18 --weight 0.4 \\\n    --moq 100 --restock-days 10\n```\n\n输出总分、各维度得分、短板识别与改进方向。\n阈值：≥75 优质款，60–74 可做款小批量测试，<60 建议放弃。\n\n### 5. 合规检查 —— compliance.py\n\n内置 175 条广告法违禁词库，分三级风险：\nP0 明令禁止（绝对化用语，命中即违法）、P1 需要资质、P2 真实性约束。\n\n```bash\npython scripts/compliance.py --text \"全网最低价，销量第一\"\npython scripts/compliance.py --file detail.txt --min-level P0\n```\n\n输出命中词、风险级别、原文上下文与整改建议。\n**命中 P0 时进程返回码为 1**，可用于批处理或 CI 流程拦截。\n\n**强制要求**：所有对外文案（标题、主图文字、详情页、短视频脚本、\n直播话术、客服话术）发布前必须扫描，P0 必须清零。\n\n### 6. 实时数据桥接 —— live.py（让前述工具\"实时可用\"）\n\n前五个工具再准，也依赖**真实入参**：你填的佣金率、退货率、进货价、搜索量，\n若靠拍脑袋就会失真。本脚本把\"先用 WebSearch/WebFetch 拉当前真实值，\n再一键灌入计算器\"标准化，解决\"估算即翻车\"的根因。\n\n```bash\n# 1) 看某平台该去哪拉实时数据（佣金率/退货率/进货价/搜索量）\npython scripts/live.py sources --platform douyin\n\n# 2) 看 live_data.json 该收集哪些字段、单位是什么\npython scripts/live.py schema\n\n# 3) 把拉到的实时值写入 live_data.json 后，生成可直接执行的命令\npython scripts/live.py plan --in live_data.json\n```\n\n`live.py` 自身不抓电商站点（规避反爬与 JS 渲染），而是：\n- `sources` 给出每个平台**官方公示页 / 公开指数工具**的权威 URL，由 Agent\n  用 WebFetch 拉取当前真实佣金率、类目退货率、1688 进货价、关键词搜索量；\n- `plan` 按\"先 pricing 算毛利率 → 再 product_score/ad_calc 串联\"的顺序，\n  生成 pricing / product_score / ad_calc / diagnose 四段命令，并标注缺失字段；\n- `stamp` 输出当前日期，报告自动带上\"数据截至 YYYY-MM-DD\"水印，\n  始终提醒以商家后台为准；\n- `fetch fx` 演示本机直连实时公开接口（汇率，跨境成本换算用），\n  网络受限时优雅降级并提示改用 Agent 侧 WebFetch。\n\n**关键约束**：`live_data.json` 里的 `gross_margin` 必须由 `pricing` 输出，\n`plan` 会强制要求先跑 pricing，保证五个工具的数据链路自洽（见 L2 测试）。\n\n### 共享数据模块 —— platform_fees.py\n\n`scripts/platform_fees.py` 是上述工具的**共享费率/基准表**（六大平台佣金率、\n支付费率、行业转化基准），被 pricing / diagnose / product_score 共同 import。\n可直接查看或校准：\n\n```bash\npython scripts/platform_fees.py        # 打印平台费率参考表\n```\n\n表内为公开参考区间，平台政策持续变化，使用前请以商家后台最新公示为准；\n任何数值都可用各脚本的 `--commission` 等参数手动覆盖。\n\n## 知识库\n\n需要方法论、平台规则或实操细节时，按需读取以下文档：\n\n- **`references/platform-playbook.md`** —— 六大平台流量机制对比、\n  淘宝搜索权重与坑产逻辑、拼多多价格力与活动起量、抖音赛马机制与 GPM、\n  京东与小红书打法、跨平台通用铁律。\n- **`references/product-selection.md`** —— 选品四道门槛（合规/利润/\n  需求/竞争）、评分模型说明、分品类退货率参考、四种产品角色矩阵、\n  供应链评估与备货公式、六大选品陷阱。\n- **`references/listing-and-content.md`** —— 各平台标题字数与结构公式、\n  主图五图法则、详情页九屏黄金结构、短视频脚本框架、直播节奏与货盘、\n  评价运营、发布前检查清单。\n- **`references/operations-playbook.md`** —— GMV 公式拆解、核心指标\n  定义与健康区间、日周月运营节奏、提升客单价六法、大促五阶段节奏、\n  售后与差评处理、平台与法律风控红线、常见问题速查。\n\n## 典型工作流\n\n### 工作流 A：评估一个新品能不能做\n\n1. 用 `product_score.py` 做六维评分，得到初步结论\n2. 若 ≥60 分，用 `pricing.py` 精算利润，确认保本售价与毛利率\n3. 用 `ad_calc.py` 代入毛利率，算出保本 ROI 与最高可承受 CPC\n4. 判断该 CPC 在目标类目是否可实现（对比行业平均 CPC）\n5. 读 `references/product-selection.md` 核对合规资质与供应链风险\n6. 输出结论：做 / 不做 / 小批量测试，并给出价格与投放边界\n\n### 工作流 B：店铺有流量但不出单\n\n1. 用 `diagnose.py` 输入完整漏斗数据，定位瓶颈环节\n2. 按输出的处方逐条执行，不要跳过优先级\n3. 若瓶颈在点击率 → 读 `listing-and-content.md` 主图章节\n4. 若瓶颈在转化率 → 读详情页九屏结构与评价运营章节\n5. 若瓶颈在支付率 → 检查运费门槛、优惠券、库存与催付\n6. 修复后重新跑 `diagnose.py` 对比验证\n\n### 工作流 C：投放亏损，ROI 做不上去\n\n1. 用 `pricing.py` 确认真实毛利率（多数人此处高估）\n2. 用 `ad_calc.py` 算保本 ROI，与实际 ROI 对比\n3. 若实际 ROI < 保本 ROI，用 `--target-roi` 反推需要的 CPC 或转化率\n4. 优先级固定为：提转化率 > 降 CPC > 提客单价\n5. 转化率问题回到工作流 B 做漏斗诊断\n\n### 工作流 D：撰写或审核商品文案\n\n1. 读 `references/listing-and-content.md` 对应章节获取结构模板\n2. 按平台字数限制与结构公式撰写\n3. 用 `compliance.py` 扫描，P0 必须清零，P1 确认资质，P2 确认可举证\n4. 对照文档末尾的发布前检查清单逐项确认\n\n### 工作流 E：用实时数据决策（推荐默认路径）\n\n当用户的提问绑定到**具体商品 / 关键词 / 平台**时，不要凭记忆填参数，\n走实时链路，让结论\"实时可用\"：\n\n1. 用 `live.py sources --platform <平台>` 拿到该平台的实时数据源 URL\n2. 用 WebSearch / WebFetch 拉取当前真实值：\n   - 类目佣金率（平台资费公示页）\n   - 类目退货率（平台/行业报告）\n   - 1688 实时进货价（搜关键词按销量排序）\n   - 关键词月搜索量 / 趋势（巨量算数、微信指数、百度指数等）\n3. 把数值写入 `live_data.json`\n4. 用 `live.py plan --in live_data.json` 生成执行命令，按序执行\n5. 报告顶部带上\"数据截至 <日期>\"水印，并提示以商家后台校准\n\n## 铁律\n\n1. **先算账，再做事。** 定价、投放、报活动、谈佣金之前，\n   必须先跑 `pricing.py` 和 `ad_calc.py`，没有保本售价与保本 ROI\n   这两个数字就是在盲目决策。\n2. **诊断优先于加预算。** 转化链路有短板时加预算只会放大亏损。\n3. **合规先于增长。** 广告法罚则起点二十万元，一次翻车抵掉全年利润。\n   所有对外文案先过 `compliance.py`。\n4. **不照搬跨平台打法。** 抖音的内容逻辑与淘宝的搜索逻辑完全不同。\n5. **数据以商家后台为准。** 本技能内置的费率、行业基准均为公开参考值，\n   实际决策必须用后台真实数据校准。\n6. **优先用实时数据，不凭记忆填参。** 用户给了具体商品/平台时，\n   先用 `live.py` + WebSearch/WebFetch 拉当前真实费率、退货率、进货价、\n   搜索量，再灌入计算器；记忆值只作缺失时的兜底，并明确标注为估算。\n7. **不编造数据。** 无法确认的数字应明确说明其为估算或参考区间，\n   并提示用户核实来源。\n\n## 免责声明\n\n本技能提供的费率、行业基准、退货率区间等均为公开信息与行业经验值，\n平台规则持续变化，使用前须以各平台官方最新公示为准。\n合规检查结果为风险自查提示，不构成法律意见，\n具体认定以市场监管部门为准。\n\nFile v1.0.2:README.md\n\n# 国内电商全链路运营 Skill（cn-ecommerce-ops）\n\n![使用演示](assets/demo.gif)\n\n一个面向 AI Agent 的**国内电商运营专家技能包**，覆盖淘宝、天猫、京东、\n拼多多、抖音电商、小红书、视频号六大平台。\n\n核心主张只有一句：**先算账，再做事。**\n\n多数电商决策失误来自三件事——不算真实利润（漏算退货与推广成本）、\n不算保本 ROI（盲目投放）、不查合规（广告法罚则起点二十万元）。\n本技能为这三件事各提供了一个可执行、可验证的确定性工具。\n\n![tests](https://img.shields.io/badge/tests-38%20passed-brightgreen)\n![python](https://img.shields.io/badge/python-3.9%2B-blue)\n![deps](https://img.shields.io/badge/dependencies-none-lightgrey)\n![license](https://img.shields.io/badge/license-MIT-green)\n![stars](https://img.shields.io/github/stars/g305595965/cn-ecommerce-ops?style=social)\n![forks](https://img.shields.io/github/forks/g305595965/cn-ecommerce-ops?style=social)\n![issues](https://img.shields.io/github/issues/g305595965/cn-ecommerce-ops)\n\n---\n\n## 为什么需要它\n\n大模型对电商的了解通常停留在\"多做内容、优化主图、提升转化率\"这类\n正确但无用的建议。真正的运营决策需要的是**数字**：\n\n- 这个价格到底赚不赚钱？退货率 30% 之后还剩多少？\n- 投放 ROI 做到多少才不亏？最高能出多少钱一个点击？\n- 有流量不出单，问题到底出在哪一环？\n- 这句文案会不会让我被罚二十万？\n\n本技能把这些问题变成可以直接算出答案的命令。\n\n---\n\n## 五个可执行工具 + 实时数据桥接\n\n全部使用 Python 3 标准库实现，**零第三方依赖**，每个脚本都内置自检。\n\n| 脚本 | 作用 | 关键输出 |\n|------|------|---------|\n| `scripts/pricing.py` | 定价与利润测算 | 单均净利、**保本售价**、**保本 ROI**、成本结构 |\n| `scripts/ad_calc.py` | 付费投放测算 | UV 价值、**可承受最高 CPC**、目标 ROI 反推 |\n| `scripts/diagnose.py` | 转化漏斗诊断 | 瓶颈环节定位、优先级处方、提升模拟 |\n| `scripts/product_score.py` | 选品六维评分 | 综合得分、短板识别与改进方向 |\n| `scripts/compliance.py` | 广告法合规检查 | 175 条违禁词库，三级风险分级与整改建议 |\n| `scripts/live.py` | **实时数据桥接** | 拉取当前真实费率/进货价/搜索量，一键灌入上述计算器 |\n\n> `scripts/platform_fees.py` 是共享数据模块（六大平台佣金率、支付费率、\n> 行业转化基准），被 pricing / diagnose / product_score 共同引用，\n> 可用 `python scripts/platform_fees.py` 直接查看，数值均可用各脚本参数覆盖。\n\n### 让工具\"实时可用\"：live.py\n\n前五个工具再准，也依赖**真实入参**。与其凭记忆填佣金率、退货率、进货价、\n搜索量，`live.py` 把\"先拉实时数据、再灌入计算器\"标准化：\n\n```bash\n# 看某平台该去哪拉实时数据（官方公示页 / 公开指数工具，无需 API key）\npython scripts/live.py sources --platform douyin\n\n# 看 live_data.json 该收集哪些字段、单位是什么\npython scripts/live.py schema\n\n# 把 WebSearch/WebFetch 拉到的实时值写入 live_data.json，生成执行命令\npython scripts/live.py plan --in live_data.json\n```\n\n`plan` 会按\"先 `pricing` 算毛利率 → 再 `product_score` / `ad_calc` 串联\"的顺序\n生成命令，并标注缺失字段；报告自动带上\"数据截至 YYYY-MM-DD\"水印。\n`live.py fetch fx` 还能本机直连实时汇率接口（跨境成本换算用），网络受限时\n优雅降级并提示改用 Agent 侧 WebFetch。\n\n详见 SKILL.md 的「实时数据路由」与工作流 E。\n\n### 亮点设计\n\n**1. 定价用 100 单基准法，而不是简单减法**\n\n退货产生的去程运费、包材、损耗都不可回收，这是\"卖爆了却在亏钱\"的\n根本原因。脚本模拟发出 100 单、其中 r% 退货，分别核算收入与成本，\n再折算回单均利润。\n\n```bash\npython scripts/pricing.py --cost 35 --price 129 --platform douyin \\\n    --shipping 4.5 --packaging 1.5 --return-rate 30 --ad-ratio 18\n```\n\n**2. 诊断看的是相对基准的偏离度，不是绝对值高低**\n\n哪个环节相对行业基准差得最多，哪个才是真瓶颈，修复它的投入产出比最高。\n\n```bash\npython scripts/diagnose.py --impression 200000 --click 2000 \\\n    --order 110 --paid 55 --gmv 6600\n```\n\n```\n  [!]  点击率         1.00%  基准 2.0~5.0%    偏低 偏离 50.0%\n  [OK] 下单率         5.50%  基准 3.0~8.0%    正常\n  [!]  支付率        50.00%  基准 60.0~85.0%  偏低 偏离 16.7%\n\n--- 瓶颈定位 ---\n  最大瓶颈: 曝光 -> 点击（点击率）\n  可能归因: 主图/短视频首帧、标题、价格带、人群精准度\n```\n\n**3. 合规检查可接入自动化流程**\n\n命中 P0（广告法明令禁止的绝对化用语）时进程返回码为 `1`，\n可直接用于批处理或 CI 拦截。\n\n```bash\npython scripts/compliance.py --file detail.txt --min-level P0\n```\n\n---\n\n## 四册知识库\n\n| 文档 | 内容 |\n|------|------|\n| `references/platform-playbook.md` | 六大平台流量机制对比、淘宝坑产逻辑、拼多多价格力、抖音赛马与 GPM、小红书 CES、冷启动路径 |\n| `references/product-selection.md` | 选品四道门槛、分品类退货率参考、四种产品角色矩阵、供应链评估与备货公式 |\n| `references/listing-and-content.md` | 标题结构公式、主图五图法则、详情页九屏结构、短视频脚本框架、直播节奏与货盘 |\n| `references/operations-playbook.md` | GMV 公式拆解、指标健康区间、日周月节奏、大促五阶段、风控红线速查 |\n\n---\n\n## 安装\n\n### WorkBuddy\n\n```bash\ngit clone https://github.com/g305595965/cn-ecommerce-ops.git ~/.workbuddy/skills/cn-ecommerce-ops\n```\n\n### Claude Code\n\n```bash\ngit clone https://github.com/g305595965/cn-ecommerce-ops.git ~/.claude/skills/cn-ecommerce-ops\n```\n\n### 手动安装\n\n下载仓库 ZIP，解压后将整个目录放入对应的 `skills/` 目录，\n确保目录内直接包含 `SKILL.md`。\n\n安装后重启客户端，向 AI 提问\"帮我算一下这个品能不能做\"即可自动触发。\n\n---\n\n## 直接当命令行工具用\n\n不依赖任何 AI 客户端，脚本本身就是完整的命令行工具：\n\n```bash\ncd scripts\n\n# 查看内置平台费率参考表\npython pricing.py --list-platforms\n\n# 算保本 ROI 和最高出价\npython ad_calc.py --price 129 --gross-margin 60 --cvr 2.5 --cpc 1.2 --target-roi 4\n\n# 选品评分\npython product_score.py --gross-margin 62 --search-index 8000 --trend up \\\n    --supply-ratio 3.2 --return-rate 18 --weight 0.4 --moq 100 --restock-days 10\n\n# 导出完整违禁词库\npython compliance.py --list-rules\n```\n\n所有脚本均支持 `--json` 输出结构化结果，方便二次开发与集成。\n\n---\n\n## 测试\n\n```bash\npython tests/run_all.py\n```\n\n三层验证，共 34 项：\n\n- **L1 单元层** —— 逐个运行各脚本内置自检（含公式自洽、单调性、异常拦截）\n- **L2 集成层** —— 验证工具链数据自洽，例如 `pricing.py` 与 `ad_calc.py`\n  两个独立脚本算出的保本 ROI 必须一致、保本售价代回后净利必须归零\n- **L3 结构层** —— 校验 SKILL.md 元数据、文件完整性，\n  以及文档中引用的每一个脚本路径是否真实存在（防止文档说谎）\n\n---\n\n## 数据来源与免责声明\n\n- 内置的平台费率、行业转化基准、分品类退货率均为**公开信息与行业经验值**，\n  文中已逐项标注。平台规则持续变化，实际决策**必须以各平台商家后台\n  最新公示为准**。\n- 合规检查基于《广告法》（2021 修正）第九条等条款及常见执法口径整理，\n  结果为**风险自查提示，不构成法律意见**，具体认定以市场监管部门为准。\n- 部分词汇在特定语境下可合规（如已取得对应批准文号），需结合实际判断。\n\n---\n\n## 贡献\n\n欢迎提 Issue 或 PR，尤其欢迎以下方向：\n\n- 补充或修正平台费率与规则（请附官方来源链接）\n- 扩充违禁词库与整改建议\n- 补充分品类的转化率与退货率基准数据\n- 修正计算模型中的口径问题\n\n提交 PR 前请运行 `python tests/run_all.py` 确保全部通过。\n\n---\n\n## License\n\n[MIT](LICENSE)\n\nFile v1.0.2:_meta.json\n\n{\n  \"ownerId\": \"kn7d4jg6kwefccgm7gdmxkzkv18c4neh\",\n  \"slug\": \"cn-ecommerce-ops\",\n  \"version\": \"1.0.2\",\n  \"publishedAt\": 1786785316345\n}\n\nFile v1.0.2:references/listing-and-content.md\n\n# 商品呈现与内容创作手册\n\n> 流量进来之后，能否转化全靠这一环。所有对外文案发布前，\n> 必须先经过 `scripts/compliance.py` 合规扫描。\n\n---\n\n## 一、标题优化\n\n### 各平台字数限制\n| 平台 | 上限 | 备注 |\n|------|------|------|\n| 淘宝 / 天猫 | 30 汉字（60 字符） | 用满，不浪费字符 |\n| 京东 | 30 汉字左右 | 品牌词前置 |\n| 拼多多 | 60 字符 | 简洁直白，突出价格力 |\n| 抖音商城 | 30 汉字左右 | 口语化，贴近搜索习惯 |\n| 小红书笔记 | 20 汉字（显示约 20 字） | 前 10 字最关键 |\n\n### 标题结构公式\n```\n营销词 + 品牌词 + 核心词 + 属性词 + 场景词 + 长尾词\n```\n\n**示例**（女士针织衫）：\n```\n2024新款 XX品牌 针织开衫 女 宽松 慵懒风 春秋 外搭 小个子 上衣\n```\n\n### 关键原则\n1. **核心词必须完整可切分** —— 不要把\"针织开衫\"拆成\"针织 时尚 开衫\"，\n   否则搜索引擎无法完整匹配\"针织开衫\"这个词。\n2. **新品用长尾词，成熟品抢大词** —— 新品没有权重，抢大词只会被淹没。\n   先用\"针织开衫女小个子慵懒风\"这类精准长尾词吃转化。\n3. **属性词必须与后台属性一致** —— 不一致会被判定为标题违规或降权。\n4. **不堆砌无关热词** —— 引来不精准流量会打乱人群标签，得不偿失。\n5. **禁用广告法违禁词** —— \"最\"字系、\"第一\"、\"国家级\"等一律不能出现。\n\n### 关键词来源\n- 平台搜索下拉框（真实用户搜索）\n- 竞品标题拆解（取交集高频词）\n- 生意参谋 / 抖音电商罗盘 / 京东商智的搜索词分析\n- 直通车关键词报表（有真实点击数据的词最可靠）\n\n---\n\n## 二、主图设计（决定点击率）\n\n### 五图 + 一视频的标准配置\n| 位置 | 作用 | 要点 |\n|------|------|------|\n| 主图 1 | 抓眼球 | 产品主体清晰 + 一句核心卖点（≤8字） |\n| 主图 2 | 卖点强化 | 最强差异化功能，用对比或数据体现 |\n| 主图 3 | 场景化 | 产品在真实使用场景中的样子 |\n| 主图 4 | 细节特写 | 材质、工艺、做工，建立品质感 |\n| 主图 5 | 信任状 | 资质证书、检测报告、售后承诺 |\n| 主图视频 | 综合展示 | 15–30 秒，前 3 秒必须有信息量 |\n\n### 提升点击率的实操要点\n- **左上角是黄金视觉区**，最重要的信息放这里（符合 F 型视觉动线）\n- 文字**不超过图片面积 20%**（平台规则），且必须大而清晰，\n  手机上缩略图只有指甲盖大小，小字等于没有\n- **色彩要跳出搜索结果页**：竞品都用白底，你用彩底就能跳出来\n- **主图必须 A/B 测试**，用直通车小预算测点击率，\n  跑出高于行业均值的图再放大投放，不要凭审美决定\n\n---\n\n## 三、详情页黄金结构\n\n用户决策路径：**我有什么问题 → 你能解决吗 → 凭什么信你 → 为什么现在买**\n\n| 屏序 | 内容 | 目的 |\n|------|------|------|\n| 第 1 屏 | 核心卖点 + 使用场景大图 | 3 秒内说清\"这是什么、解决什么\" |\n| 第 2 屏 | 痛点场景还原 | 引发共鸣：\"这说的就是我\" |\n| 第 3 屏 | 解决方案 + 核心功能 | 给出答案 |\n| 第 4 屏 | 参数与规格 | 满足理性决策需求 |\n| 第 5 屏 | 细节展示 | 材质、做工、工艺 |\n| 第 6 屏 | 信任背书 | 资质、检测报告、销量、媒体报道 |\n| 第 7 屏 | 用户评价 / 买家秀 | 从众心理，真实感最重要 |\n| 第 8 屏 | 售后保障 | 消除最后顾虑（七天无理由、运费险、质保） |\n| 第 9 屏 | 促销信息 + 行动号召 | 临门一脚，制造合理紧迫感 |\n\n**核心原则**：\n- **前三屏决定 70% 的跳失**，最强的内容必须前置\n- 移动端优先，单张图高度不超过 1200px，避免加载过慢\n- **不要用大段文字**，用图 + 短句，用户是\"扫\"不是\"读\"\n- 促销紧迫感必须**真实**（虚构倒计时构成价格欺诈）\n\n---\n\n## 四、短视频带货脚本框架\n\n### 黄金 3 秒开场（决定生死）\n四种经过验证的开场方式：\n1. **痛点直击** —— \"你是不是也这样...\"\n2. **结果前置** —— 直接展示使用后的效果\n3. **反常识冲突** —— \"千万别再这样做了\"\n4. **身份代入** —— \"小个子女生一定要看\"\n\n### 30–60 秒脚本结构\n```\n0–3s   黄金开场（痛点/结果/冲突）\n3–10s  问题放大（为什么这件事很麻烦）\n10–25s 产品出场 + 核心卖点演示（要看得见的效果）\n25–40s 使用场景 + 效果展示\n40–50s 信任背书（销量/资质/真实反馈）\n50–60s 行动号召 + 利益点（限时优惠、赠品）\n```\n\n### 关键指标与优化方向\n| 指标不达标 | 优化位置 |\n|-----------|---------|\n| 3 秒完播率低 | 开场没抓住人，重做前 3 秒 |\n| 完播率低 | 中段节奏拖沓，删冗余镜头 |\n| 点击率低 | 挂车时机不对，或产品与内容不匹配 |\n| 转化率低 | 落地页承接问题，看详情页与价格 |\n\n---\n\n## 五、直播运营\n\n### 单场直播节奏（15–25 分钟一个循环）\n```\n1. 引流憋单（3–5 分钟）\n   用福利款/秒杀留人，拉停留时长，积累在线人数\n2. 产品讲解（8–12 分钟）\n   痛点 → 卖点 → 演示 → 对比 → 信任状\n3. 逼单成交（3–5 分钟）\n   限时限量、价格锚点、赠品叠加，倒数上链接\n4. 循环往复\n```\n\n### 货盘结构\n- **福利款** —— 引流留人，亏本或平本，控制数量\n- **爆款/主推款** —— 走量核心，占销售额 50% 以上\n- **利润款** —— 赚钱主力\n- **形象款** —— 拉高客单价与直播间调性\n\n### 核心指标诊断\n| 指标 | 说明 | 偏低时的动作 |\n|------|------|------------|\n| 平均停留时长 | 低于 30 秒说明开场有问题 | 改开场话术、加福利钩子 |\n| UV 价值 | 成交额 ÷ 观看人数 | 提高转化或客单价 |\n| 转化率 | 成交人数 ÷ 观看人数 | 优化讲解与逼单话术 |\n| 互动率 | 评论点赞 ÷ 观看 | 增加互动引导与抽奖 |\n\n---\n\n## 六、评价与口碑运营\n\n评价是转化率的**决定性因素之一**，尤其是前 10 条。\n\n### 实操要点\n- **首批评价至关重要**，必须确保真实优质，带图带视频\n- 主动引导评价：包裹卡（不得以好评返现诱导，平台明令禁止）、\n  售后回访、会员积分\n- **差评必须第一时间响应**，公开回复要克制专业，\n  展现解决问题的态度——回复是给后来的潜在买家看的\n- **定期分析差评关键词**，这是产品迭代最真实的输入源\n- 「问大家」板块同样影响转化，需要主动维护\n\n### 合规红线\n- **好评返现属于违规行为**，平台会处罚，且涉嫌违反《反不正当竞争法》\n- **刷单炒信违法**，情节严重可构成犯罪\n- 不得**删除或屏蔽真实差评**\n\n---\n\n## 七、发布前检查清单\n\n每一条对外内容发布前，逐项确认：\n\n- [ ] 已运行 `python scripts/compliance.py --file 文案.txt`，无 P0 命中\n- [ ] 标题字数未超限，核心词完整可切分\n- [ ] 后台属性与标题、详情页描述完全一致\n- [ ] 主图无违规文字占比，无第三方品牌/水印\n- [ ] 价格与优惠券逻辑正确，划线价为真实成交价\n- [ ] 所有宣称的功效/资质均有对应证明文件\n- [ ] 促销时间与库存真实可兑现\n- [ ] 无站外引流信息（小红书、抖音尤其严格）\n\nFile v1.0.2:references/operations-playbook.md\n\n# 日常运营、数据体系与风控手册\n\n---\n\n## 一、GMV 公式拆解：所有运营动作的起点\n\n```\nGMV = 曝光量 × 点击率 × 转化率 × 客单价\n    = 访客数(UV) × 转化率 × 客单价\n    = 访客数 × UV 价值\n```\n\n**任何提升 GMV 的动作，必然落在这四个变量之一上。**\n说不清自己在优化哪个变量的运营动作，都是无效动作。\n\n| 变量 | 提升手段 | 见 |\n|------|---------|-----|\n| 曝光量 | 关键词覆盖、付费投放、活动坑位、内容分发 | platform-playbook.md |\n| 点击率 | 主图、标题、价格带、人群精准度 | listing-and-content.md |\n| 转化率 | 详情页、评价、价格力、信任状、客服 | listing-and-content.md |\n| 客单价 | 套餐搭配、满减凑单、关联推荐、升级款 | 本文第四节 |\n\n**诊断顺序**：先用 `scripts/diagnose.py` 找出最短板的环节，\n再针对性投入。四个变量都及格时，才应该加大流量投入。\n\n---\n\n## 二、核心指标定义与健康区间\n\n### 流量与转化\n| 指标 | 计算方式 | 说明 |\n|------|---------|------|\n| UV | 独立访客数 | 流量规模 |\n| 点击率 CTR | 点击 ÷ 曝光 | 主图与标题的吸引力 |\n| 转化率 CVR | 支付人数 ÷ 访客数 | 承接能力 |\n| UV 价值 | 支付金额 ÷ 访客数 | 单个流量的产值，投放的核心依据 |\n| 客单价 | 支付金额 ÷ 支付人数 | 单笔订单规模 |\n| 加购收藏率 | 加购收藏 ÷ 访客 | 潜在需求，预示后续转化 |\n\n### 投放效率\n| 指标 | 计算方式 | 说明 |\n|------|---------|------|\n| ROI / ROAS | 成交金额 ÷ 广告花费 | 投产比 |\n| 保本 ROI | 1 ÷ 毛利率 | 低于此值必亏，用 `ad_calc.py` 算 |\n| CPC | 花费 ÷ 点击 | 点击单价 |\n| CPA | 花费 ÷ 成交单数 | 获客成本 |\n| GPM | 成交额 ÷ 曝光 × 1000 | 抖音核心指标 |\n\n### 服务与健康度\n| 指标 | 健康区间（经验值） | 影响 |\n|------|-----------------|------|\n| DSR 动态评分 | ≥ 4.8 | 低于均值影响搜索权重 |\n| 退款率 | 低于行业均值 | 超标直接降权 |\n| 退款自主完结时长 | 越短越好 | 影响服务分 |\n| 发货时效 | 24–48 小时内 | 超时罚款且降权 |\n| 客服响应时长 | < 30 秒 | 影响转化与服务分 |\n| 纠纷率 | 越低越好 | 严重时限制活动报名 |\n\n**重要**：各平台的服务分（抖音体验分、拼多多服务分、天猫 DSR）\n直接决定能否报名活动、能否获得流量扶持，是运营的生命线。\n\n---\n\n## 三、运营节奏\n\n### 每日必做（30 分钟）\n1. 看昨日核心数据：GMV、UV、转化率、ROI，与前一日/上周同期对比\n2. 检查异常：流量突降、转化突降、差评、退款激增\n3. 处理待发货订单，确保不超时\n4. 回复所有评价与「问大家」\n5. 检查广告计划消耗与 ROI，暂停明显亏损的计划\n\n### 每周必做\n1. 拉取周数据，做转化漏斗诊断（`diagnose.py`）\n2. 关键词报表分析：加词、删词、调价\n3. 竞品监控：价格、活动、新品、主图变化\n4. 库存盘点，触发补货\n5. 复盘本周投放，输出下周计划\n\n### 每月必做\n1. 全店产品结构复盘：引流/利润/形象/狙击款的贡献占比\n2. 利润核算（`pricing.py` 实算，不看毛估）\n3. 差评关键词聚类，输出产品改进需求\n4. 下月活动排期与备货计划\n\n---\n\n## 四、提升客单价的六种手段\n\n1. **满减凑单** —— 门槛设在客单价的 1.5 倍左右最有效\n2. **套餐组合** —— 主品 + 配件打包，比单卖利润更高\n3. **多规格阶梯定价** —— 买 2 件更划算，直接拉高件单价\n4. **关联推荐** —— 详情页底部与购物车页推荐互补品\n5. **升级款引导** —— 用价格锚点让中间档看起来最划算\n6. **赠品换购** —— 加 X 元换购高感知价值商品\n\n**注意**：提升客单价往往会降低转化率，\n需用 `ad_calc.py` 验证 UV 价值（客单价 × 转化率）是否净提升。\n\n---\n\n## 五、大促节奏（以双 11 / 618 为例）\n\n| 阶段 | 时间 | 核心动作 |\n|------|------|---------|\n| 预热蓄水 | 提前 30–45 天 | 上新、内容种草、拉新加购收藏 |\n| 加购蓄水 | 提前 10–15 天 | 定金预售、优惠券发放、直播预告 |\n| 爆发期 | 大促当日 | 全力投放、直播续场、客服全员待命 |\n| 返场期 | 后 3–7 天 | 承接犹豫用户，清理尾货 |\n| 复盘期 | 后 7–15 天 | 数据复盘、退货处理、库存消化 |\n\n**易踩的坑**：\n- **备货不足**：爆单后断货，权重与口碑双杀\n- **备货过量**：大促后长期库存积压，现金流枯竭\n- **价格穿底**：为冲量把价格打到亏损，大促后无法恢复原价\n- **客服崩盘**：响应超时导致服务分下降，影响后续流量\n- **物流爆仓**：预留发货缓冲，提前与快递协商产能\n\n---\n\n## 六、售后与客服\n\n### 降低退货率的实操手段\n1. **前置预期管理** —— 详情页把尺码、色差、材质说清楚，\n   宁可少卖也不要卖错。预期落差是退货第一原因。\n2. **尺码表要给真实数据** —— 服饰类提供模特身高体重与穿着尺码\n3. **主动售后** —— 发货后主动推送物流，签收后回访\n4. **退货原因分析** —— 每月聚类分析，反推产品与文案问题\n\n### 差评处理原则\n- **第一时间响应**，24 小时内\n- 公开回复是**写给潜在买家看的**，不是写给差评者看的：\n  克制、专业、给出解决方案，不辩解不对骂\n- 私下联系解决实际问题，能挽回则挽回\n- **不得删除或屏蔽真实差评**，也不得骚扰要求修改评价\n\n---\n\n## 七、风控红线（触碰即重罚）\n\n### 平台层面\n| 违规行为 | 后果 |\n|---------|------|\n| 刷单炒信 | 扣分、降权、清退，情节严重构成犯罪 |\n| 虚假发货 | 高额罚款 + 降权 |\n| 延迟发货 | 按单赔付 + 服务分下降 |\n| 售假/侵权 | 商品下架、扣分、店铺关闭、保证金扣除 |\n| 盗用他人图片 | 侵权投诉、删除链接、赔偿 |\n| 描述不符 | 退款率上升 + 平台处罚 |\n| 站外引流 | 小红书/抖音尤其严格，限流至封号 |\n| 好评返现 | 违规且涉嫌违反《反不正当竞争法》 |\n\n### 法律层面\n- **《广告法》第九条** —— 绝对化用语，罚款起点二十万元。\n  所有文案发布前必须过 `scripts/compliance.py`。\n- **《消费者权益保护法》** —— 七天无理由退货义务\n- **《电子商务法》** —— 平台内经营者需公示营业执照、依法纳税\n- **《反不正当竞争法》** —— 禁止虚假宣传、刷单、诋毁竞争对手\n- **《价格法》** —— 禁止虚构原价、虚假优惠折价\n\n### 自查频率建议\n- 每次上新：合规扫描 + 资质核对\n- 每周：抽查在售商品文案\n- 每月：全店文案批量扫描（`compliance.py --file`）\n- 平台规则更新时：立即全店自查\n\n---\n\n## 八、常见问题速查\n\n**Q：流量突然下降怎么办？**\n按顺序排查：① 是否有违规扣分 ② 关键词排名是否掉了\n③ 竞品是否有大动作 ④ 是否是类目大盘下滑（看行业数据）\n⑤ 主图/标题/价格是否被改动 ⑥ 广告计划是否被暂停或预算耗尽。\n\n**Q：有流量没转化？**\n用 `diagnose.py` 定位具体环节。常见原因：流量不精准（人群标签乱了）、\n价格无竞争力、评价有硬伤、详情页说服力不足。\n\n**Q：ROI 一直做不上去？**\n用 `ad_calc.py` 先算保本 ROI。若当前 ROI 低于保本值，\n优先级是：提转化率 > 降 CPC > 提客单价。\n盲目加预算只会放大亏损。\n\n**Q：要不要做低价冲量？**\n先算账。低价冲量会打乱人群标签、拉低客单价心智，\n且平台比价机制会记录历史低价。除非有明确的冲层级/冲活动目标，\n否则不建议。用 `pricing.py` 算出保本售价，绝不低于此价。\n\nFile v1.0.2:references/platform-playbook.md\n\n# 国内六大电商平台流量机制与打法\n\n> 说明：本文为运营实操经验总结。平台算法与规则持续迭代，具体权重口径以\n> 各平台商家后台官方文档、规则中心公示为准。文中标注「经验值」的部分为\n> 行业普遍认知，非平台官方公布数据。\n\n---\n\n## 一、机制差异总览\n\n不同平台的底层逻辑决定了打法完全不同，照搬必死。\n\n| 平台 | 流量本质 | 用户心智 | 决定性指标 | 起量关键 |\n|------|---------|---------|-----------|---------|\n| 淘宝/天猫 | 搜索为主 + 推荐 | 有明确需求，货比三家 | 单坑产出（坑产） | 关键词卡位 + 人群标签 |\n| 京东 | 搜索为主 | 品质与时效优先 | 转化率 + 客单价 | 类目排名 + 物流时效 |\n| 拼多多 | 推荐为主 | 价格敏感，冲动下单 | 价格力 + 销量 | 活动坑位 + 低价冲量 |\n| 抖音 | 内容推荐 | 无明确需求，被激发 | GPM（千次观看成交额） | 内容点击率 + 转化效率 |\n| 小红书 | 内容搜索 + 推荐 | 决策前查攻略 | 笔记互动率 | 关键词种草 + 口碑沉淀 |\n| 视频号/微信小店 | 社交推荐 + 私域 | 信任驱动 | 复购率 | 私域沉淀 + 社交裂变 |\n\n**核心判断**：需求明确的标品去淘宝/京东/拼多多，需求需要被创造的\n非标品、新奇特产品去抖音/小红书。\n\n---\n\n## 二、淘宝 / 天猫\n\n### 搜索排序的权重构成（经验值）\n优先级从高到低：\n\n1. **类目相关性** —— 类目放错，后面全白搭。这是一票否决项。\n2. **文本相关性** —— 标题关键词与搜索词的匹配度\n3. **商品权重** —— 单坑产出（该关键词下的支付金额）、转化率、收藏加购率\n4. **店铺权重** —— 店铺层级、DSR 评分、退款率、纠纷率\n5. **个性化标签** —— 商品人群标签与搜索用户标签的匹配度\n\n**「坑产」是淘宝搜索的核心**：同一个关键词下，谁的支付金额高，谁排前面。\n所以刷低价单破坏的不只是转化率，更是把人群标签打乱。\n\n### 店铺层级\n按近 30 天支付金额分为 7 层。**跨层是流量分水岭**，同层商家互相竞争。\n卡在层级边缘时，冲一把跨层的收益远大于日常优化。\n\n### 标题规范\n- 天猫/淘宝标题上限 **30 个汉字（60 字符）**\n- 结构：`营销词 + 品牌词 + 核心词 + 属性词 + 长尾词`\n- 核心词必须放在能被完整切分的位置，避免关键词被拆散\n- 不留空格可提高字符利用率，但要保证可读性\n- 新品期用**精准长尾词**，有基础销量后再抢大词\n\n### 新品冷启动路径\n1. **0–7 天**：上架后打标（新品标），完善所有属性，主图/详情页做足\n2. **7–14 天**：用精准长尾词做基础销量 5–10 单 + 真实评价 + 买家秀\n3. **14–30 天**：直通车测图测款，跑出点击率高于行业均值的主图\n4. **30 天后**：有数据基础后放大投放，逐步抢中大词\n\n### 付费工具\n- **直通车（标准推广）** —— 关键词竞价，控词控人群，测款测图首选\n- **引力魔方** —— 人群定向，拉新与收割，适合推荐流量\n- **万相台无界** —— 智能化投放，托管出价，适合缺乏投放经验的商家\n\n---\n\n## 三、拼多多\n\n### 核心逻辑\n拼多多是**推荐流量为主**的平台，首页推荐占比远高于搜索。\n用户决策路径极短，价格力是第一位的。\n\n### 权重构成（经验值）\n`销量 + 转化率 + 价格力 + 服务分（DSR/发货时效/纠纷率）`\n\n**价格力**：平台会拿你的商品与全网同款比价，价格无优势直接失去推荐流量。\n\n### 起量路径\n1. 新品上架，先用**低价 + 低毛利**冲基础销量与评价\n2. 报名平台活动坑位：**限时秒杀、9块9特卖、百亿补贴**\n3. 活动带来的爆发销量会反哺自然推荐流量\n4. 有权重后再逐步调价，或用高毛利款承接流量\n\n### 推广工具\n- **搜索推广** —— 关键词竞价，意图明确\n- **场景推广** —— 推荐位竞价，走量核心\n- **明星店铺 / 全站推广** —— 智能投放\n\n**注意**：拼多多对**发货时效与售后**极其严格，延迟发货、虚假发货罚款重，\n\"仅退款\"政策对商家不友好，选品要充分考虑退货与纠纷成本。\n\n---\n\n## 四、抖音电商（兴趣电商）\n\n### 流量机制：赛马制\n内容发布后进入初始流量池（经验值约 300–500 曝光），\n系统根据数据表现决定是否推入下一级流量池。**层层赛马，逐级放大**。\n\n因此**前 500 次曝光的数据表现决定了这条内容的生死**。\n\n### 最核心指标：GPM\n```\nGPM = 成交金额 ÷ 曝光人数 × 1000\n```\n即\"每一千次观看能产生多少成交额\"。抖音判断是否给你更多流量，\n本质就是看你的流量变现效率，GPM 越高，系统越愿意给量。\n\n**提升 GPM 只有三条路**：提高点击率、提高转化率、提高客单价。\n\n### 短视频带货关键指标\n| 指标 | 参考基准（经验值） | 影响 |\n|------|-----------------|------|\n| 3 秒完播率 | > 45% | 决定是否继续推流 |\n| 完播率 | > 15% | 内容质量核心信号 |\n| 点击率（视频→商品） | > 3% | 挂车吸引力 |\n| 转化率 | > 3% | 商品详情承接力 |\n\n**黄金 3 秒**：前 3 秒必须给出冲突、痛点或结果，否则直接划走。\n\n### 直播间核心指标\n- **停留时长** —— 低于 30 秒说明开场话术或货品有问题\n- **互动率** —— 评论、点赞、加粉，影响推流\n- **UV 价值** = 成交额 ÷ 观看人数，直播间的\"坑产\"\n- **转化率** —— 场观到成交\n\n**直播节奏**：憋单引流 → 讲解产品 → 逼单成交 → 循环。\n每个循环 15–25 分钟，福利款引流、利润款赚钱、形象款拉高客单。\n\n### 付费工具：巨量千川\n- **随心推** —— 简易版，适合小额加热内容\n- **专业版-控成本投放** —— 设定成交出价，系统控制 CPA，稳定但量少\n- **专业版-放量投放** —— 不控成本，冲量用，风险高\n- **常见打法**：先用小额测素材，跑出高 CTR 素材后再放大投放\n\n### 达人分销\n通过**精选联盟**挂佣金，招募达人带货。\n佣金率通常设置在 **10%–30%**（另需支付平台技术服务费）。\n高佣金能吸引达人，但要先用 pricing.py 算清楚是否还有利润空间。\n\n---\n\n## 五、京东\n\n### 特点\n- 用户**购买意图明确**，客单价与转化率普遍高于其他平台\n- **物流时效是核心竞争力**，使用京东物流对搜索权重和转化都有正向影响\n- 3C 数码、家电品类优势明显\n\n### POP 店铺权重\n`销量 + 转化率 + 好评率 + 店铺星级（店铺评分）+ 物流时效`\n\n### 推广工具：京准通\n- **快车** —— 关键词竞价，等同直通车\n- **京东直投 / 购物触点** —— 站内展示位\n- **京挑客** —— 达人分销\n\n**注意**：京东有平台使用费和类目扣点，POP 店铺还有保证金要求，\n入驻门槛高于淘宝，但客单价与利润空间通常更好。\n\n---\n\n## 六、小红书\n\n### 平台本质\n**决策前的攻略平台**。用户在这里\"查作业\"，然后可能在小红书买，\n也可能去淘宝/天猫下单。所以小红书的价值不只是 GMV，更是**心智种草**。\n\n### 笔记权重：CES 评分（业内经验公式，官方未公开）\n```\nCES = 点赞×1 + 收藏×1 + 评论×4 + 转发×4 + 关注×8\n```\n**收藏与评论的价值远高于点赞**，因为它们代表\"真实有用\"。\n所以笔记结尾引导收藏（\"先码住\"）比引导点赞更有效。\n\n### 内容策略\n- 标题必须带**核心搜索关键词**，小红书搜索流量占比高\n- 正文自然植入关键词 3–5 次，结尾带 3–5 个精准话题标签\n- 封面图是点击率的决定因素，竖版 3:4，文字信息清晰\n- **真实感 > 精致感**，过度商业化的内容会被限流\n\n### 合规红线\n- 商业笔记必须通过**蒲公英平台**报备，否则会被判违规限流\n- 严禁**站外引流**（留微信、淘口令），轻则限流重则封号\n- 医美、保健品等类目有严格的内容限制\n\n### 变现路径\n1. 笔记种草 → 小红书商城闭环成交\n2. 笔记种草 → 用户去其他平台搜索品牌词下单（需做好品牌词承接）\n3. 买手直播带货\n\n---\n\n## 七、视频号 / 微信小店\n\n### 核心价值\n**社交推荐 + 私域沉淀**。依托微信生态，信任成本低，复购率高。\n\n### 打法\n- 公域：视频号内容推荐、直播广场\n- 私域：社群、朋友圈、公众号导流至小店\n- **社交裂变**：拼团、分享有礼在微信生态天然适配\n\n适合**高复购、需要信任背书**的品类（食品、母婴、健康、知识付费）。\n\n---\n\n## 八、跨平台通用铁律\n\n1. **不要照搬打法**。抖音的爆款视频思路搬到淘宝详情页会水土不服。\n2. **先算账再投流**。任何投放前先用 `pricing.py` 与 `ad_calc.py`\n   算出保本 ROI 与最高可承受 CPC，没有这两个数字就是在盲投。\n3. **人群标签一旦打乱，恢复成本极高**。低价冲量、非目标人群引流\n   会污染标签，导致后续精准流量失效。\n4. **合规先于增长**。所有对外文案先过 `compliance.py`，\n   广告法罚则起点二十万，一次翻车抵掉全年利润。\n5. **数据诊断优先于加预算**。转化链路有短板时加预算等于放大亏损，\n   先用 `diagnose.py` 定位瓶颈。\n\nFile v1.0.2:references/product-selection.md\n\n# 选品方法论与决策框架\n\n> 选品决定了 70% 的结果。运营能力只能放大选品的正确性，无法逆转错误的选品。\n\n---\n\n## 一、选品的四道门槛（顺序不可颠倒）\n\n任何一款产品，必须按顺序通过以下四关，前一关不过直接淘汰，不要留恋。\n\n### 第一关：合规关（一票否决）\n先确认能不能卖，再谈赚不赚钱。\n\n| 品类 | 强制要求 |\n|------|---------|\n| 3C 电子、儿童玩具、电器 | CCC 强制认证 |\n| 食品 | 食品经营许可证、SC 生产许可 |\n| 化妆品 | 化妆品备案凭证；美白/祛斑需「国妆特字」批文 |\n| 保健食品 | 蓝帽子批准文号 |\n| 医疗器械 | 一/二/三类医疗器械经营备案或许可 |\n| 图书音像 | 出版物经营许可证 |\n| 品牌商品 | 品牌授权书（缺失即侵权下架） |\n\n**知识产权排查**：外观专利、实用新型专利、商标、著作权。\n跨境或新奇特产品尤其容易踩专利雷，一封投诉信可能导致全店冻结。\n\n### 第二关：利润关\n用 `scripts/pricing.py` 实算，不要凭感觉。\n\n**判断标准（经验值）**：\n- 毛利率 **< 40%** —— 无法承担付费流量，只能靠自然流量，慎入\n- 毛利率 **40%–60%** —— 可做，但投放空间紧张，需精细化运营\n- 毛利率 **> 60%** —— 有充足投放空间，可以打爆款\n\n**必须算进去但最容易被忽略的成本**：\n去程运费、退货回程运费、包材、平台佣金、支付手续费、\n推广费、客服人力分摊、仓储分摊、坏账与损耗。\n\n### 第三关：需求关\n判断这个东西**到底有没有人要**。\n\n- **搜索型平台（淘宝/京东/拼多多）**：看关键词搜索指数与趋势。\n  搜索量持续下滑的品类不要进，那是在接盘。\n- **推荐型平台（抖音/小红书）**：看话题热度、同类内容互动量。\n  已经有内容跑出爆款说明需求被验证，完全没有内容的要警惕是伪需求。\n- **季节性判断**：提前 45–60 天布局。夏季品五月才上架已经晚了。\n\n### 第四关：竞争关\n```\n供需比 = 关键词搜索人气 ÷ 在售商品数\n```\n供需比越高说明需求大而供给少，机会越大。\n\n**竞争格局判断**：\n- 头部（TOP10）占据 80% 以上份额 → 垄断市场，新手勿入\n- 头部分散，长尾商家有销量 → 有机会切入\n- 全是白牌低价厮杀 → 除非有供应链成本优势，否则不进\n\n---\n\n## 二、选品评分模型\n\n用 `scripts/product_score.py` 量化打分，避免拍脑袋决策。\n六个维度，加权总分 100 分：\n\n| 维度 | 权重 | 评分要点 |\n|------|-----|---------|\n| 利润空间 | 25% | 毛利率高低，是否支撑投放 |\n| 市场需求 | 20% | 搜索量/内容热度及趋势方向 |\n| 竞争强度 | 20% | 供需比、头部集中度 |\n| 退货风险 | 15% | 品类退货率、尺码/色差问题 |\n| 物流成本 | 10% | 重量体积、易碎性、发货难度 |\n| 供应链 | 10% | 起订量、翻单速度、账期 |\n\n**决策阈值（经验值）**：\n- **≥ 75 分** —— 优质款，可重点投入资源打造\n- **60–74 分** —— 可做款，小批量测试后再决定\n- **< 60 分** —— 放弃，机会成本太高\n\n---\n\n## 三、按退货率划分的品类风险\n\n退货率是国内电商最容易被低估的利润杀手，尤其在抖音等冲动消费场景。\n\n| 品类 | 退货率参考区间（经验值） | 主要原因 |\n|------|----------------------|---------|\n| 服饰鞋帽 | 30%–50%（直播可达 60%+） | 尺码、色差、版型预期落差 |\n| 美妆护肤 | 10%–20% | 肤感不符、过敏 |\n| 3C 数码 | 5%–15% | 参数不符、质量问题 |\n| 家居日用 | 10%–20% | 尺寸不符、材质预期 |\n| 食品生鲜 | 5%–15% | 物流损耗、口味 |\n| 图书文具 | 3%–8% | 相对最低 |\n\n**关键**：服饰类在抖音直播场景退货率可能超过 50%，\n用 `pricing.py --return-rate 50` 算一下，很多\"爆单\"其实是巨亏。\n\n---\n\n## 四、产品结构：四种角色缺一不可\n\n单靠一款产品无法支撑店铺，必须搭建产品矩阵。\n\n1. **引流款**（占比 20%）\n   低价高需求，用于获取流量与新客，毛利可接近于零，甚至微亏。\n   考核指标是**引流效率**（UV 成本），不是利润。\n\n2. **利润款**（占比 30%）\n   店铺的现金流来源，毛利率 60% 以上，靠引流款带来的流量承接转化。\n   考核指标是**利润额**。\n\n3. **形象款**（占比 10%）\n   高客单、高品质，拉高店铺整体调性与客单价，销量不高但不可缺。\n   考核指标是**客单价拉升**。\n\n4. **狙击款**（占比 40%）\n   对标竞品的同款或改良款，用于抢占竞品流量，价格与卖点针对性设计。\n   考核指标是**市场份额**。\n\n---\n\n## 五、供应链与备货\n\n### 供应商评估要点\n- **起订量（MOQ）** —— 首单不要压太多货，测款期用小单快反\n- **翻单速度** —— 爆款出现后能否 7 天内补货，这决定能否吃到红利\n- **账期** —— 现结还是月结，直接影响资金周转\n- **质检能力** —— 次品率高会推高退货率，摧毁店铺权重\n- **是否支持一件代发** —— 起步期降低库存风险\n\n### 备货公式\n```\n安全库存 = 日均销量 × 补货周期天数 × (1 + 安全系数)\n建议备货量 = 预估日销 × 备货天数 - 现有库存 - 在途库存\n```\n安全系数一般取 **0.2–0.5**，大促期间取上限。\n\n**备货铁律**：\n- 新品测试期：只备**7–15 天**销量，宁可断货也不要压死资金\n- 稳定期：备**20–30 天**销量\n- 大促前：按预估峰值备货，但要留好尾货处理方案\n- **季节性商品必须在季末前清空**，压到下一年的库存基本等于亏损\n\n---\n\n## 六、常见选品陷阱\n\n1. **自嗨式选品** —— \"我觉得这个好\"。市场数据才是唯一依据。\n2. **只看销量不看利润** —— 卖爆了却在亏钱，是最常见的死法。\n3. **忽略退货率** —— 服饰类尤其致命，退货率算错一切归零。\n4. **忽略专利与授权** —— 尤其是新奇特产品与品牌周边。\n5. **盲目跟风爆款** —— 你看到爆款时，红利期通常已过，\n   且价格战已经开始，此时入场是接盘。\n6. **供应链没谈好就推爆款** —— 推爆了补不上货，权重掉光，得不偿失。\n\nFile v1.0.2:skill-card.md\n\n## Description:\n\ncn-ecommerce-ops helps agents support China-focused e-commerce operations with product scoring, pricing and profit calculation, advertising ROI analysis, conversion-funnel diagnosis, copy compliance checks, and current-data command planning.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[g305595965](https://clawhub.ai/user/g305595965)\n\n### License/Terms of Use:\n\nMIT\n\n## Use Case:\n\nExternal users and developers use this skill to make operational decisions for Chinese e-commerce stores, including product selection, pricing, paid-ad planning, store diagnostics, listing content, live-commerce workflows, and advertising-law copy review.\n\n### Deployment Geography for Use:\n\nGlobal, for China-focused e-commerce workflows where the user is authorized to access the relevant platform and business data.\n\n## Known Risks and Mitigations:\n\nRisk: The skill may ask the agent to look up current e-commerce data or use user-provided business inputs.\n\nMitigation: Use only accounts, platform pages, and business data that the user is authorized to access, and confirm important values against merchant backends before relying on the result.\n\nRisk: The skill may read user-selected local text or JSON files for analysis.\n\nMitigation: Provide only intended files and avoid secrets or unrelated personal data in the inputs.\n\nRisk: Generated live.py command plans can be influenced by inaccurate or untrusted input JSON.\n\nMitigation: Review generated command plans and missing-field notes before execution, especially when the source JSON was supplied by an untrusted party.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/g305595965/skills/cn-ecommerce-ops)\n- [Server-resolved GitHub provenance](https://github.com/g305595965/cn-ecommerce-ops)\n- [Platform Playbook](references/platform-playbook.md)\n- [Product Selection Framework](references/product-selection.md)\n- [Listing and Content Guide](references/listing-and-content.md)\n- [Operations and Risk Playbook](references/operations-playbook.md)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown guidance with optional JSON output and shell-command snippets]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Python scripts use standard library only and support --json output; live.py can generate command plans from user-provided JSON data.]\n\n## Skill Version(s):\n\n1.0.2 (source: ClawHub release metadata; artifact frontmatter says 1.1.0)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.0.2:examples/realtime_demo_保温杯_douyin.json\n\n{\n  \"meta\": {\n    \"keyword\": \"316不锈钢保温杯(500ml)\",\n    \"platform\": \"douyin\",\n    \"as_of\": \"2026-08-15\",\n    \"note\": \"实时数据来源: 抖音厨具佣金率取自抖店规则中心2026资费标准+九大扶持政策(常规2%-5%,厨具免佣可至0.6%); 进货价取自1688/义乌购316保温杯实时批发页(¥12-15); 退货率取饮具类6.7%-12%中值; 热度/趋势取自1688夏季爆款榜(趋势向上). 搜索量/供需比为估算proxy,请于巨量算数/生意参谋核实.\"\n  },\n  \"cost\": 12.0,\n  \"price\": 49.9,\n  \"commission\": 2.0,\n  \"shipping\": 3.0,\n  \"packaging\": 1.5,\n  \"return_rate\": 10.0,\n  \"ad_ratio\": 18.0,\n  \"search_index\": 120000,\n  \"trend\": \"up\",\n  \"supply_ratio\": 3.0,\n  \"weight_kg\": 0.4,\n  \"fragile\": false,\n  \"moq\": 10,\n  \"restock_days\": 3,\n  \"cvr\": 2.5,\n  \"cpc\": 1.5\n}\n\nFile v1.0.2:LICENSE\n\nMIT License\n\nCopyright (c) 2026 g305595965\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\nArchive v1.0.1: 17 files, 2763055 bytes\n\nFiles: assets/demo.gif (2923122b), LICENSE (1067b), README.md (6984b), references/listing-and-content.md (7524b), references/operations-playbook.md (7991b), references/platform-playbook.md (9588b), references/product-selection.md (6444b), scripts/ad_calc.py (11720b), scripts/compliance.py (15008b), scripts/diagnose.py (12096b), scripts/platform_fees.py (4678b), scripts/pricing.py (13642b), scripts/product_score.py (13926b), skill-card.md (2433b), SKILL.md (10611b), tests/run_all.py (9018b), _meta.json (135b)\n\nFile v1.0.1:SKILL.md\n\n---\r\nname: cn-ecommerce-ops\r\nversion: 1.0.1\r\ndescription: 国内电商全链路运营专家技能，覆盖淘宝、天猫、京东、拼多多、抖音电商、小红书、视频号六大平台。提供选品评分、定价与利润测算、广告投放ROI测算、店铺转化漏斗诊断、广告法违禁词合规检查五个可执行工具，以及平台流量机制、选品方法论、标题主图详情页优化、直播短视频、运营节奏与风控的完整知识库。当用户涉及国内电商选品、定价、算利润、算ROI、投直通车或千川、做店铺诊断、优化标题主图详情页、写商品文案、直播运营、检查文案是否违反广告法、平台规则与流量玩法等问题时，应使用本技能。\r\nauthor: g305595965\r\nrepository: https://github.com/g305595965/cn-ecommerce-ops\r\nlicense: MIT\r\ntags:\r\n  - 电商\r\n  - 国内电商\r\n  - 淘宝\r\n  - 天猫\r\n  - 京东\r\n  - 拼多多\r\n  - 抖音电商\r\n  - 小红书\r\n  - 视频号\r\n  - 选品\r\n  - 定价\r\n  - 利润\r\n  - ROI\r\n  - 广告投放\r\n  - 漏斗诊断\r\n  - 广告法\r\n  - 合规\r\ntriggers:\r\n  - 国内电商\r\n  - 电商运营\r\n  - 定价测算\r\n  - 利润计算\r\n  - 保本价\r\n  - 广告ROI\r\n  - 投放ROI\r\n  - 转化漏斗\r\n  - 漏斗诊断\r\n  - 选品评分\r\n  - 广告法违禁词\r\n  - 极限词检查\r\n  - 淘宝运营\r\n  - 抖音电商\r\n  - 小红书运营\r\nagent_created: true\r\n---\r\n\r\n# 国内电商全链路运营\r\n\r\n## 概述\r\n\r\n本技能把国内电商运营中最依赖经验判断的环节，转化为可计算、可复核的\r\n决策流程。核心主张是：**先算账，再做事**。\r\n\r\n多数电商决策失误源于三件事——不算真实利润（漏算退货与推广成本）、\r\n不算保本 ROI（盲目投放）、不查合规（广告法罚则起点二十万元）。\r\n本技能为这三件事各提供了确定性工具。\r\n\r\n## 何时使用\r\n\r\n在遇到以下任一场景时使用本技能：\r\n\r\n- 判断某款产品值不值得做（选品评估、竞品分析）\r\n- 定价、核算真实利润、计算保本售价\r\n- 投放前测算保本 ROI、可承受最高出价、目标 ROI 反推\r\n- 店铺流量正常但不出单、转化率下滑、ROI 做不上去\r\n- 撰写或审核商品标题、主图文案、详情页、短视频脚本、直播话术\r\n- 检查文案是否触碰广告法违禁词与极限词\r\n- 了解淘宝/天猫/京东/拼多多/抖音/小红书的流量机制与冷启动打法\r\n- 制定日常运营节奏、大促排期、备货计划\r\n\r\n## 快速路由\r\n\r\n根据用户问题类型，选择对应工具或文档：\r\n\r\n| 用户问题类型 | 使用 |\r\n|------------|------|\r\n| 这个品能不能做 | `scripts/product_score.py` + `references/product-selection.md` |\r\n| 卖多少钱／能赚多少／保本价 | `scripts/pricing.py` |\r\n| 广告怎么投／ROI 多少才不亏／出价多少 | `scripts/ad_calc.py` |\r\n| 有流量不出单／哪个环节有问题 | `scripts/diagnose.py` |\r\n| 文案能不能这么写／会不会违规 | `scripts/compliance.py` |\r\n| 平台怎么起量／算法逻辑 | `references/platform-playbook.md` |\r\n| 标题主图详情页／短视频／直播 | `references/listing-and-content.md` |\r\n| 日常怎么做／大促怎么排／怎么防违规 | `references/operations-playbook.md` |\r\n\r\n## 可执行工具\r\n\r\n全部脚本使用 Python 3 标准库，无第三方依赖，可直接运行。\r\n所有脚本均支持 `--json` 输出结构化结果，支持 `--self-test` 自检。\r\n运行前先切换到 `scripts/` 目录，或确保该目录在 `PYTHONPATH` 中。\r\n\r\n### 1. 定价与利润测算 —— pricing.py\r\n\r\n采用 100 单基准法核算，把退货造成的去程运费、包材、损耗全部计入，\r\n这是\"卖爆了却在亏钱\"的根本原因。\r\n\r\n```bash\r\npython scripts/pricing.py --cost 35 --price 129 --platform douyin \\\r\n    --shipping 4.5 --packaging 1.5 --return-rate 30 --ad-ratio 18\r\n```\r\n\r\n输出单均净利、净利率、毛利率、**保本售价**、**保本 ROI** 与成本结构。\r\n`--list-platforms` 查看内置平台费率参考表。\r\n\r\n**关键用法**：在任何定价、报价、谈达人佣金、参加活动前先跑一次。\r\n得到的\"保本售价\"是价格底线，\"保本 ROI\"是投放的生死线。\r\n\r\n### 2. 投放测算 —— ad_calc.py\r\n\r\n适用于直通车、万相台、巨量千川、京准通、多多推广等所有 CPC 场景。\r\n\r\n```bash\r\npython scripts/ad_calc.py --price 129 --gross-margin 60 --cvr 2.5 --cpc 1.2 \\\r\n    --budget 2000 --target-roi 4\r\n```\r\n\r\n输出 UV 价值、当前 ROI、保本 ROI、**可承受最高 CPC**、CPA、\r\n日预算测算，以及达成目标 ROI 所需的 CPC 或转化率（二选一路径）。\r\n\r\n**核心恒等式**：`ROI = UV价值 ÷ CPC`，`保本ROI = 1 ÷ 毛利率`。\r\n毛利率参数应使用 `pricing.py` 算出的毛利率，两个工具串联使用。\r\n\r\n### 3. 转化漏斗诊断 —— diagnose.py\r\n\r\n不看哪个数字低，而是看**哪个环节相对行业基准差得最多**，\r\n偏离最大的环节即为瓶颈，优先修复它的投入产出比最高。\r\n\r\n```bash\r\npython scripts/diagnose.py --impression 200000 --click 2000 --cart 200 \\\r\n    --order 110 --paid 55 --refund 8 --gmv 6600\r\n```\r\n\r\n输出各环节转化率与基准对比、瓶颈定位、按优先级排序的处方，\r\n以及\"瓶颈修复到基准后订单能涨多少\"的提升模拟。\r\n\r\n**使用原则**：转化链路存在短板时加预算等于放大亏损，先诊断再投放。\r\n\r\n### 4. 选品六维评分 —— product_score.py\r\n\r\n利润空间 25%、市场需求 20%、竞争强度 20%、退货风险 15%、\r\n物流成本 10%、供应链 10%，加权总分 100。\r\n\r\n```bash\r\npython scripts/product_score.py --gross-margin 62 --search-index 8000 \\\r\n    --trend up --supply-ratio 3.2 --return-rate 18 --weight 0.4 \\\r\n    --moq 100 --restock-days 10\r\n```\r\n\r\n输出总分、各维度得分、短板识别与改进方向。\r\n阈值：≥75 优质款，60–74 可做款小批量测试，<60 建议放弃。\r\n\r\n### 5. 合规检查 —— compliance.py\r\n\r\n内置 175 条广告法违禁词库，分三级风险：\r\nP0 明令禁止（绝对化用语，命中即违法）、P1 需要资质、P2 真实性约束。\r\n\r\n```bash\r\npython scripts/compliance.py --text \"全网最低价，销量第一\"\r\npython scripts/compliance.py --file detail.txt --min-level P0\r\n```\r\n\r\n输出命中词、风险级别、原文上下文与整改建议。\r\n**命中 P0 时进程返回码为 1**，可用于批处理或 CI 流程拦截。\r\n\r\n**强制要求**：所有对外文案（标题、主图文字、详情页、短视频脚本、\r\n直播话术、客服话术）发布前必须扫描，P0 必须清零。\r\n\r\n## 知识库\r\n\r\n需要方法论、平台规则或实操细节时，按需读取以下文档：\r\n\r\n- **`references/platform-playbook.md`** —— 六大平台流量机制对比、\r\n  淘宝搜索权重与坑产逻辑、拼多多价格力与活动起量、抖音赛马机制与 GPM、\r\n  京东与小红书打法、跨平台通用铁律。\r\n- **`references/product-selection.md`** —— 选品四道门槛（合规/利润/\r\n  需求/竞争）、评分模型说明、分品类退货率参考、四种产品角色矩阵、\r\n  供应链评估与备货公式、六大选品陷阱。\r\n- **`references/listing-and-content.md`** —— 各平台标题字数与结构公式、\r\n  主图五图法则、详情页九屏黄金结构、短视频脚本框架、直播节奏与货盘、\r\n  评价运营、发布前检查清单。\r\n- **`references/operations-playbook.md`** —— GMV 公式拆解、核心指标\r\n  定义与健康区间、日周月运营节奏、提升客单价六法、大促五阶段节奏、\r\n  售后与差评处理、平台与法律风控红线、常见问题速查。\r\n\r\n## 典型工作流\r\n\r\n### 工作流 A：评估一个新品能不能做\r\n\r\n1. 用 `product_score.py` 做六维评分，得到初步结论\r\n2. 若 ≥60 分，用 `pricing.py` 精算利润，确认保本售价与毛利率\r\n3. 用 `ad_calc.py` 代入毛利率，算出保本 ROI 与最高可承受 CPC\r\n4. 判断该 CPC 在目标类目是否可实现（对比行业平均 CPC）\r\n5. 读 `references/product-selection.md` 核对合规资质与供应链风险\r\n6. 输出结论：做 / 不做 / 小批量测试，并给出价格与投放边界\r\n\r\n### 工作流 B：店铺有流量但不出单\r\n\r\n1. 用 `diagnose.py` 输入完整漏斗数据，定位瓶颈环节\r\n2. 按输出的处方逐条执行，不要跳过优先级\r\n3. 若瓶颈在点击率 → 读 `listing-and-content.md` 主图章节\r\n4. 若瓶颈在转化率 → 读详情页九屏结构与评价运营章节\r\n5. 若瓶颈在支付率 → 检查运费门槛、优惠券、库存与催付\r\n6. 修复后重新跑 `diagnose.py` 对比验证\r\n\r\n### 工作流 C：投放亏损，ROI 做不上去\r\n\r\n1. 用 `pricing.py` 确认真实毛利率（多数人此处高估）\r\n2. 用 `ad_calc.py` 算保本 ROI，与实际 ROI 对比\r\n3. 若实际 ROI < 保本 ROI，用 `--target-roi` 反推需要的 CPC 或转化率\r\n4. 优先级固定为：提转化率 > 降 CPC > 提客单价\r\n5. 转化率问题回到工作流 B 做漏斗诊断\r\n\r\n### 工作流 D：撰写或审核商品文案\r\n\r\n1. 读 `references/listing-and-content.md` 对应章节获取结构模板\r\n2. 按平台字数限制与结构公式撰写\r\n3. 用 `compliance.py` 扫描，P0 必须清零，P1 确认资质，P2 确认可举证\r\n4. 对照文档末尾的发布前检查清单逐项确认\r\n\r\n## 铁律\r\n\r\n1. **先算账，再做事。** 定价、投放、报活动、谈佣金之前，\r\n   必须先跑 `pricing.py` 和 `ad_calc.py`，没有保本售价与保本 ROI\r\n   这两个数字就是在盲目决策。\r\n2. **诊断优先于加预算。** 转化链路有短板时加预算只会放大亏损。\r\n3. **合规先于增长。** 广告法罚则起点二十万元，一次翻车抵掉全年利润。\r\n   所有对外文案先过 `compliance.py`。\r\n4. **不照搬跨平台打法。** 抖音的内容逻辑与淘宝的搜索逻辑完全不同。\r\n5. **数据以商家后台为准。** 本技能内置的费率、行业基准均为公开参考值，\r\n   实际决策必须用后台真实数据校准。\r\n6. **不编造数据。** 无法确认的数字应明确说明其为估算或参考区间，\r\n   并提示用户核实来源。\r\n\r\n## 免责声明\r\n\r\n本技能提供的费率、行业基准、退货率区间等均为公开信息与行业经验值，\r\n平台规则持续变化，使用前须以各平台官方最新公示为准。\r\n合规检查结果为风险自查提示，不构成法律意见，\r\n具体认定以市场监管部门为准。\n\nFile v1.0.1:README.md\n\n# 国内电商全链路运营 Skill（cn-ecommerce-ops）\n\n![使用演示](assets/demo.gif)\n\n一个面向 AI Agent 的**国内电商运营专家技能包**，覆盖淘宝、天猫、京东、\n拼多多、抖音电商、小红书、视频号六大平台。\n\n核心主张只有一句：**先算账，再做事。**\n\n多数电商决策失误来自三件事——不算真实利润（漏算退货与推广成本）、\n不算保本 ROI（盲目投放）、不查合规（广告法罚则起点二十万元）。\n本技能为这三件事各提供了一个可执行、可验证的确定性工具。\n\n![tests](https://img.shields.io/badge/tests-34%20passed-brightgreen)\n![python](https://img.shields.io/badge/python-3.9%2B-blue)\n![deps](https://img.shields.io/badge/dependencies-none-lightgrey)\n![license](https://img.shields.io/badge/license-MIT-green)\n![stars](https://img.shields.io/github/stars/g305595965/cn-ecommerce-ops?style=social)\n![forks](https://img.shields.io/github/forks/g305595965/cn-ecommerce-ops?style=social)\n![issues](https://img.shields.io/github/issues/g305595965/cn-ecommerce-ops)\n\n---\n\n## 为什么需要它\n\n大模型对电商的了解通常停留在\"多做内容、优化主图、提升转化率\"这类\n正确但无用的建议。真正的运营决策需要的是**数字**：\n\n- 这个价格到底赚不赚钱？退货率 30% 之后还剩多少？\n- 投放 ROI 做到多少才不亏？最高能出多少钱一个点击？\n- 有流量不出单，问题到底出在哪一环？\n- 这句文案会不会让我被罚二十万？\n\n本技能把这些问题变成可以直接算出答案的命令。\n\n---\n\n## 五个可执行工具\n\n全部使用 Python 3 标准库实现，**零第三方依赖**，每个脚本都内置自检。\n\n| 脚本 | 作用 | 关键输出 |\n|------|------|---------|\n| `scripts/pricing.py` | 定价与利润测算 | 单均净利、**保本售价**、**保本 ROI**、成本结构 |\n| `scripts/ad_calc.py` | 付费投放测算 | UV 价值、**可承受最高 CPC**、目标 ROI 反推 |\n| `scripts/diagnose.py` | 转化漏斗诊断 | 瓶颈环节定位、优先级处方、提升模拟 |\n| `scripts/product_score.py` | 选品六维评分 | 综合得分、短板识别与改进方向 |\n| `scripts/compliance.py` | 广告法合规检查 | 175 条违禁词库，三级风险分级与整改建议 |\n\n### 亮点设计\n\n**1. 定价用 100 单基准法，而不是简单减法**\n\n退货产生的去程运费、包材、损耗都不可回收，这是\"卖爆了却在亏钱\"的\n根本原因。脚本模拟发出 100 单、其中 r% 退货，分别核算收入与成本，\n再折算回单均利润。\n\n```bash\npython scripts/pricing.py --cost 35 --price 129 --platform douyin \\\n    --shipping 4.5 --packaging 1.5 --return-rate 30 --ad-ratio 18\n```\n\n**2. 诊断看的是相对基准的偏离度，不是绝对值高低**\n\n哪个环节相对行业基准差得最多，哪个才是真瓶颈，修复它的投入产出比最高。\n\n```bash\npython scripts/diagnose.py --impression 200000 --click 2000 \\\n    --order 110 --paid 55 --gmv 6600\n```\n\n```\n  [!]  点击率         1.00%  基准 2.0~5.0%    偏低 偏离 50.0%\n  [OK] 下单率         5.50%  基准 3.0~8.0%    正常\n  [!]  支付率        50.00%  基准 60.0~85.0%  偏低 偏离 16.7%\n\n--- 瓶颈定位 ---\n  最大瓶颈: 曝光 -> 点击（点击率）\n  可能归因: 主图/短视频首帧、标题、价格带、人群精准度\n```\n\n**3. 合规检查可接入自动化流程**\n\n命中 P0（广告法明令禁止的绝对化用语）时进程返回码为 `1`，\n可直接用于批处理或 CI 拦截。\n\n```bash\npython scripts/compliance.py --file detail.txt --min-level P0\n```\n\n---\n\n## 四册知识库\n\n| 文档 | 内容 |\n|------|------|\n| `references/platform-playbook.md` | 六大平台流量机制对比、淘宝坑产逻辑、拼多多价格力、抖音赛马与 GPM、小红书 CES、冷启动路径 |\n| `references/product-selection.md` | 选品四道门槛、分品类退货率参考、四种产品角色矩阵、供应链评估与备货公式 |\n| `references/listing-and-content.md` | 标题结构公式、主图五图法则、详情页九屏结构、短视频脚本框架、直播节奏与货盘 |\n| `references/operations-playbook.md` | GMV 公式拆解、指标健康区间、日周月节奏、大促五阶段、风控红线速查 |\n\n---\n\n## 安装\n\n### WorkBuddy\n\n```bash\ngit clone https://github.com/g305595965/cn-ecommerce-ops.git ~/.workbuddy/skills/cn-ecommerce-ops\n```\n\n### Claude Code\n\n```bash\ngit clone https://github.com/g305595965/cn-ecommerce-ops.git ~/.claude/skills/cn-ecommerce-ops\n```\n\n### 手动安装\n\n下载仓库 ZIP，解压后将整个目录放入对应的 `skills/` 目录，\n确保目录内直接包含 `SKILL.md`。\n\n安装后重启客户端，向 AI 提问\"帮我算一下这个品能不能做\"即可自动触发。\n\n---\n\n## 直接当命令行工具用\n\n不依赖任何 AI 客户端，脚本本身就是完整的命令行工具：\n\n```bash\ncd scripts\n\n# 查看内置平台费率参考表\npython pricing.py --list-platforms\n\n# 算保本 ROI 和最高出价\npython ad_calc.py --price 129 --gross-margin 60 --cvr 2.5 --cpc 1.2 --target-roi 4\n\n# 选品评分\npython product_score.py --gross-margin 62 --search-index 8000 --trend up \\\n    --supply-ratio 3.2 --return-rate 18 --weight 0.4 --moq 100 --restock-days 10\n\n# 导出完整违禁词库\npython compliance.py --list-rules\n```\n\n所有脚本均支持 `--json` 输出结构化结果，方便二次开发与集成。\n\n---\n\n## 测试\n\n```bash\npython tests/run_all.py\n```\n\n三层验证，共 34 项：\n\n- **L1 单元层** —— 逐个运行各脚本内置自检（含公式自洽、单调性、异常拦截）\n- **L2 集成层** —— 验证工具链数据自洽，例如 `pricing.py` 与 `ad_calc.py`\n  两个独立脚本算出的保本 ROI 必须一致、保本售价代回后净利必须归零\n- **L3 结构层** —— 校验 SKILL.md 元数据、文件完整性，\n  以及文档中引用的每一个脚本路径是否真实存在（防止文档说谎）\n\n---\n\n## 数据来源与免责声明\n\n- 内置的平台费率、行业转化基准、分品类退货率均为**公开信息与行业经验值**，\n  文中已逐项标注。平台规则持续变化，实际决策**必须以各平台商家后台\n  最新公示为准**。\n- 合规检查基于《广告法》（2021 修正）第九条等条款及常见执法口径整理，\n  结果为**风险自查提示，不构成法律意见**，具体认定以市场监管部门为准。\n- 部分词汇在特定语境下可合规（如已取得对应批准文号），需结合实际判断。\n\n---\n\n## 贡献\n\n欢迎提 Issue 或 PR，尤其欢迎以下方向：\n\n- 补充或修正平台费率与规则（请附官方来源链接）\n- 扩充违禁词库与整改建议\n- 补充分品类的转化率与退货率基准数据\n- 修正计算模型中的口径问题\n\n提交 PR 前请运行 `python tests/run_all.py` 确保全部通过。\n\n---\n\n## License\n\n[MIT](LICENSE)\n\nFile v1.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn7d4jg6kwefccgm7gdmxkzkv18c4neh\",\n  \"slug\": \"cn-ecommerce-ops\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1786298436777\n}\n\nFile v1.0.1:references/listing-and-content.md\n\n# 商品呈现与内容创作手册\n\n> 流量进来之后，能否转化全靠这一环。所有对外文案发布前，\n> 必须先经过 `scripts/compliance.py` 合规扫描。\n\n---\n\n## 一、标题优化\n\n### 各平台字数限制\n| 平台 | 上限 | 备注 |\n|------|------|------|\n| 淘宝 / 天猫 | 30 汉字（60 字符） | 用满，不浪费字符 |\n| 京东 | 30 汉字左右 | 品牌词前置 |\n| 拼多多 | 60 字符 | 简洁直白，突出价格力 |\n| 抖音商城 | 30 汉字左右 | 口语化，贴近搜索习惯 |\n| 小红书笔记 | 20 汉字（显示约 20 字） | 前 10 字最关键 |\n\n### 标题结构公式\n```\n营销词 + 品牌词 + 核心词 + 属性词 + 场景词 + 长尾词\n```\n\n**示例**（女士针织衫）：\n```\n2024新款 XX品牌 针织开衫 女 宽松 慵懒风 春秋 外搭 小个子 上衣\n```\n\n### 关键原则\n1. **核心词必须完整可切分** —— 不要把\"针织开衫\"拆成\"针织 时尚 开衫\"，\n   否则搜索引擎无法完整匹配\"针织开衫\"这个词。\n2. **新品用长尾词，成熟品抢大词** —— 新品没有权重，抢大词只会被淹没。\n   先用\"针织开衫女小个子慵懒风\"这类精准长尾词吃转化。\n3. **属性词必须与后台属性一致** —— 不一致会被判定为标题违规或降权。\n4. **不堆砌无关热词** —— 引来不精准流量会打乱人群标签，得不偿失。\n5. **禁用广告法违禁词** —— \"最\"字系、\"第一\"、\"国家级\"等一律不能出现。\n\n### 关键词来源\n- 平台搜索下拉框（真实用户搜索）\n- 竞品标题拆解（取交集高频词）\n- 生意参谋 / 抖音电商罗盘 / 京东商智的搜索词分析\n- 直通车关键词报表（有真实点击数据的词最可靠）\n\n---\n\n## 二、主图设计（决定点击率）\n\n### 五图 + 一视频的标准配置\n| 位置 | 作用 | 要点 |\n|------|------|------|\n| 主图 1 | 抓眼球 | 产品主体清晰 + 一句核心卖点（≤8字） |\n| 主图 2 | 卖点强化 | 最强差异化功能，用对比或数据体现 |\n| 主图 3 | 场景化 | 产品在真实使用场景中的样子 |\n| 主图 4 | 细节特写 | 材质、工艺、做工，建立品质感 |\n| 主图 5 | 信任状 | 资质证书、检测报告、售后承诺 |\n| 主图视频 | 综合展示 | 15–30 秒，前 3 秒必须有信息量 |\n\n### 提升点击率的实操要点\n- **左上角是黄金视觉区**，最重要的信息放这里（符合 F 型视觉动线）\n- 文字**不超过图片面积 20%**（平台规则），且必须大而清晰，\n  手机上缩略图只有指甲盖大小，小字等于没有\n- **色彩要跳出搜索结果页**：竞品都用白底，你用彩底就能跳出来\n- **主图必须 A/B 测试**，用直通车小预算测点击率，\n  跑出高于行业均值的图再放大投放，不要凭审美决定\n\n---\n\n## 三、详情页黄金结构\n\n用户决策路径：**我有什么问题 → 你能解决吗 → 凭什么信你 → 为什么现在买**\n\n| 屏序 | 内容 | 目的 |\n|------|------|------|\n| 第 1 屏 | 核心卖点 + 使用场景大图 | 3 秒内说清\"这是什么、解决什么\" |\n| 第 2 屏 | 痛点场景还原 | 引发共鸣：\"这说的就是我\" |\n| 第 3 屏 | 解决方案 + 核心功能 | 给出答案 |\n| 第 4 屏 | 参数与规格 | 满足理性决策需求 |\n| 第 5 屏 | 细节展示 | 材质、做工、工艺 |\n| 第 6 屏 | 信任背书 | 资质、检测报告、销量、媒体报道 |\n| 第 7 屏 | 用户评价 / 买家秀 | 从众心理，真实感最重要 |\n| 第 8 屏 | 售后保障 | 消除最后顾虑（七天无理由、运费险、质保） |\n| 第 9 屏 | 促销信息 + 行动号召 | 临门一脚，制造合理紧迫感 |\n\n**核心原则**：\n- **前三屏决定 70% 的跳失**，最强的内容必须前置\n- 移动端优先，单张图高度不超过 1200px，避免加载过慢\n- **不要用大段文字**，用图 + 短句，用户是\"扫\"不是\"读\"\n- 促销紧迫感必须**真实**（虚构倒计时构成价格欺诈）\n\n---\n\n## 四、短视频带货脚本框架\n\n### 黄金 3 秒开场（决定生死）\n四种经过验证的开场方式：\n1. **痛点直击** —— \"你是不是也这样...\"\n2. **结果前置** —— 直接展示使用后的效果\n3. **反常识冲突** —— \"千万别再这样做了\"\n4. **身份代入** —— \"小个子女生一定要看\"\n\n### 30–60 秒脚本结构\n```\n0–3s   黄金开场（痛点/结果/冲突）\n3–10s  问题放大（为什么这件事很麻烦）\n10–25s 产品出场 + 核心卖点演示（要看得见的效果）\n25–40s 使用场景 + 效果展示\n40–50s 信任背书（销量/资质/真实反馈）\n50–60s 行动号召 + 利益点（限时优惠、赠品）\n```\n\n### 关键指标与优化方向\n| 指标不达标 | 优化位置 |\n|-----------|---------|\n| 3 秒完播率低 | 开场没抓住人，重做前 3 秒 |\n| 完播率低 | 中段节奏拖沓，删冗余镜头 |\n| 点击率低 | 挂车时机不对，或产品与内容不匹配 |\n| 转化率低 | 落地页承接问题，看详情页与价格 |\n\n---\n\n## 五、直播运营\n\n### 单场直播节奏（15–25 分钟一个循环）\n```\n1. 引流憋单（3–5 分钟）\n   用福利款/秒杀留人，拉停留时长，积累在线人数\n2. 产品讲解（8–12 分钟）\n   痛点 → 卖点 → 演示 → 对比 → 信任状\n3. 逼单成交（3–5 分钟）\n   限时限量、价格锚点、赠品叠加，倒数上链接\n4. 循环往复\n```\n\n### 货盘结构\n- **福利款** —— 引流留人，亏本或平本，控制数量\n- **爆款/主推款** —— 走量核心，占销售额 50% 以上\n- **利润款** —— 赚钱主力\n- **形象款** —— 拉高客单价与直播间调性\n\n### 核心指标诊断\n| 指标 | 说明 | 偏低时的动作 |\n|------|------|------------|\n| 平均停留时长 | 低于 30 秒说明开场有问题 | 改开场话术、加福利钩子 |\n| UV 价值 | 成交额 ÷ 观看人数 | 提高转化或客单价 |\n| 转化率 | 成交人数 ÷ 观看人数 | 优化讲解与逼单话术 |\n| 互动率 | 评论点赞 ÷ 观看 | 增加互动引导与抽奖 |\n\n---\n\n## 六、评价与口碑运营\n\n评价是转化率的**决定性因素之一**，尤其是前 10 条。\n\n### 实操要点\n- **首批评价至关重要**，必须确保真实优质，带图带视频\n- 主动引导评价：包裹卡（不得以好评返现诱导，平台明令禁止）、\n  售后回访、会员积分\n- **差评必须第一时间响应**，公开回复要克制专业，\n  展现解决问题的态度——回复是给后来的潜在买家看的\n- **定期分析差评关键词**，这是产品迭代最真实的输入源\n- 「问大家」板块同样影响转化，需要主动维护\n\n### 合规红线\n- **好评返现属于违规行为**，平台会处罚，且涉嫌违反《反不正当竞争法》\n- **刷单炒信违法**，情节严重可构成犯罪\n- 不得**删除或屏蔽真实差评**\n\n---\n\n## 七、发布前检查清单\n\n每一条对外内容发布前，逐项确认：\n\n- [ ] 已运行 `python scripts/compliance.py --file 文案.txt`，无 P0 命中\n- [ ] 标题字数未超限，核心词完整可切分\n- [ ] 后台属性与标题、详情页描述完全一致\n- [ ] 主图无违规文字占比，无第三方品牌/水印\n- [ ] 价格与优惠券逻辑正确，划线价为真实成交价\n- [ ] 所有宣称的功效/资质均有对应证明文件\n- [ ] 促销时间与库存真实可兑现\n- [ ] 无站外引流信息（小红书、抖音尤其严格）\n\nFile v1.0.1:references/operations-playbook.md\n\n# 日常运营、数据体系与风控手册\n\n---\n\n## 一、GMV 公式拆解：所有运营动作的起点\n\n```\nGMV = 曝光量 × 点击率 × 转化率 × 客单价\n    = 访客数(UV) × 转化率 × 客单价\n    = 访客数 × UV 价值\n```\n\n**任何提升 GMV 的动作，必然落在这四个变量之一上。**\n说不清自己在优化哪个变量的运营动作，都是无效动作。\n\n| 变量 | 提升手段 | 见 |\n|------|---------|-----|\n| 曝光量 | 关键词覆盖、付费投放、活动坑位、内容分发 | platform-playbook.md |\n| 点击率 | 主图、标题、价格带、人群精准度 | listing-and-content.md |\n| 转化率 | 详情页、评价、价格力、信任状、客服 | listing-and-content.md |\n| 客单价 | 套餐搭配、满减凑单、关联推荐、升级款 | 本文第四节 |\n\n**诊断顺序**：先用 `scripts/diagnose.py` 找出最短板的环节，\n再针对性投入。四个变量都及格时，才应该加大流量投入。\n\n---\n\n## 二、核心指标定义与健康区间\n\n### 流量与转化\n| 指标 | 计算方式 | 说明 |\n|------|---------|------|\n| UV | 独立访客数 | 流量规模 |\n| 点击率 CTR | 点击 ÷ 曝光 | 主图与标题的吸引力 |\n| 转化率 CVR | 支付人数 ÷ 访客数 | 承接能力 |\n| UV 价值 | 支付金额 ÷ 访客数 | 单个流量的产值，投放的核心依据 |\n| 客单价 | 支付金额 ÷ 支付人数 | 单笔订单规模 |\n| 加购收藏率 | 加购收藏 ÷ 访客 | 潜在需求，预示后续转化 |\n\n### 投放效率\n| 指标 | 计算方式 | 说明 |\n|------|---------|------|\n| ROI / ROAS | 成交金额 ÷ 广告花费 | 投产比 |\n| 保本 ROI | 1 ÷ 毛利率 | 低于此值必亏，用 `ad_calc.py` 算 |\n| CPC | 花费 ÷ 点击 | 点击单价 |\n| CPA | 花费 ÷ 成交单数 | 获客成本 |\n| GPM | 成交额 ÷ 曝光 × 1000 | 抖音核心指标 |\n\n### 服务与健康度\n| 指标 | 健康区间（经验值） | 影响 |\n|------|-----------------|------|\n| DSR 动态评分 | ≥ 4.8 | 低于均值影响搜索权重 |\n| 退款率 | 低于行业均值 | 超标直接降权 |\n| 退款自主完结时长 | 越短越好 | 影响服务分 |\n| 发货时效 | 24–48 小时内 | 超时罚款且降权 |\n| 客服响应时长 | < 30 秒 | 影响转化与服务分 |\n| 纠纷率 | 越低越好 | 严重时限制活动报名 |\n\n**重要**：各平台的服务分（抖音体验分、拼多多服务分、天猫 DSR）\n直接决定能否报名活动、能否获得流量扶持，是运营的生命线。\n\n---\n\n## 三、运营节奏\n\n### 每日必做（30 分钟）\n1. 看昨日核心数据：GMV、UV、转化率、ROI，与前一日/上周同期对比\n2. 检查异常：流量突降、转化突降、差评、退款激增\n3. 处理待发货订单，确保不超时\n4. 回复所有评价与「问大家」\n5. 检查广告计划消耗与 ROI，暂停明显亏损的计划\n\n### 每周必做\n1. 拉取周数据，做转化漏斗诊断（`diagnose.py`）\n2. 关键词报表分析：加词、删词、调价\n3. 竞品监控：价格、活动、新品、主图变化\n4. 库存盘点，触发补货\n5. 复盘本周投放，输出下周计划\n\n### 每月必做\n1. 全店产品结构复盘：引流/利润/形象/狙击款的贡献占比\n2. 利润核算（`pricing.py` 实算，不看毛估）\n3. 差评关键词聚类，输出产品改进需求\n4. 下月活动排期与备货计划\n\n---\n\n## 四、提升客单价的六种手段\n\n1. **满减凑单** —— 门槛设在客单价的 1.5 倍左右最有效\n2. **套餐组合** —— 主品 + 配件打包，比单卖利润更高\n3. **多规格阶梯定价** —— 买 2 件更划算，直接拉高件单价\n4. **关联推荐** —— 详情页底部与购物车页推荐互补品\n5. **升级款引导** —— 用价格锚点让中间档看起来最划算\n6. **赠品换购** —— 加 X 元换购高感知价值商品\n\n**注意**：提升客单价往往会降低转化率，\n需用 `ad_calc.py` 验证 UV 价值（客单价 × 转化率）是否净提升。\n\n---\n\n## 五、大促节奏（以双 11 / 618 为例）\n\n| 阶段 | 时间 | 核心动作 |\n|------|------|---------|\n| 预热蓄水 | 提前 30–45 天 | 上新、内容种草、拉新加购收藏 |\n| 加购蓄水 | 提前 10–15 天 | 定金预售、优惠券发放、直播预告 |\n| 爆发期 | 大促当日 | 全力投放、直播续场、客服全员待命 |\n| 返场期 | 后 3–7 天 | 承接犹豫用户，清理尾货 |\n| 复盘期 | 后 7–15 天 | 数据复盘、退货处理、库存消化 |\n\n**易踩的坑**：\n- **备货不足**：爆单后断货，权重与口碑双杀\n- **备货过量**：大促后长期库存积压，现金流枯竭\n- **价格穿底**：为冲量把价格打到亏损，大促后无法恢复原价\n- **客服崩盘**：响应超时导致服务分下降，影响后续流量\n- **物流爆仓**：预留发货缓冲，提前与快递协商产能\n\n---\n\n## 六、售后与客服\n\n### 降低退货率的实操手段\n1. **前置预期管理** —— 详情页把尺码、色差、材质说清楚，\n   宁可少卖也不要卖错。预期落差是退货第一原因。\n2. **尺码表要给真实数据** —— 服饰类提供模特身高体重与穿着尺码\n3. **主动售后** —— 发货后主动推送物流，签收后回访\n4. **退货原因分析** —— 每月聚类分析，反推产品与文案问题\n\n### 差评处理原则\n- **第一时间响应**，24 小时内\n- 公开回复是**写给潜在买家看的**，不是写给差评者看的：\n  克制、专业、给出解决方案，不辩解不对骂\n- 私下联系解决实际问题，能挽回则挽回\n- **不得删除或屏蔽真实差评**，也不得骚扰要求修改评价\n\n---\n\n## 七、风控红线（触碰即重罚）\n\n### 平台层面\n| 违规行为 | 后果 |\n|---------|------|\n| 刷单炒信 | 扣分、降权、清退，情节严重构成犯罪 |\n| 虚假发货 | 高额罚款 + 降权 |\n| 延迟发货 | 按单赔付 + 服务分下降 |\n| 售假/侵权 | 商品下架、扣分、店铺关闭、保证金扣除 |\n| 盗用他人图片 | 侵权投诉、删除链接、赔偿 |\n| 描述不符 | 退款率上升 + 平台处罚 |\n| 站外引流 | 小红书/抖音尤其严格，限流至封号 |\n| 好评返现 | 违规且涉嫌违反《反不正当竞争法》 |\n\n### 法律层面\n- **《广告法》第九条** —— 绝对化用语，罚款起点二十万元。\n  所有文案发布前必须过 `scripts/compliance.py`。\n- **《消费者权益保护法》** —— 七天无理由退货义务\n- **《电子商务法》** —— 平台内经营者需公示营业执照、依法纳税\n- **《反不正当竞争法》** —— 禁止虚假宣传、刷单、诋毁竞争对手\n- **《价格法》** —— 禁止虚构原价、虚假优惠折价\n\n### 自查频率建议\n- 每次上新：合规扫描 + 资质核对\n- 每周：抽查在售商品文案\n- 每月：全店文案批量扫描（`compliance.py --file`）\n- 平台规则更新时：立即全店自查\n\n---\n\n## 八、常见问题速查\n\n**Q：流量突然下降怎么办？**\n按顺序排查：① 是否有违规扣分 ② 关键词排名是否掉了\n③ 竞品是否有大动作 ④ 是否是类目大盘下滑（看行业数据）\n⑤ 主图/标题/价格是否被改动 ⑥ 广告计划是否被暂停或预算耗尽。\n\n**Q：有流量没转化？**\n用 `diagnose.py` 定位具体环节。常见原因：流量不精准（人群标签乱了）、\n价格无竞争力、评价有硬伤、详情页说服力不足。\n\n**Q：ROI 一直做不上去？**\n用 `ad_calc.py` 先算保本 ROI。若当前 ROI 低于保本值，\n优先级是：提转化率 > 降 CPC > 提客单价。\n盲目加预算只会放大亏损。\n\n**Q：要不要做低价冲量？**\n先算账。低价冲量会打乱人群标签、拉低客单价心智，\n且平台比价机制会记录历史低价。除非有明确的冲层级/冲活动目标，\n否则不建议。用 `pricing.py` 算出保本售价，绝不低于此价。\n\nFile v1.0.1:references/platform-playbook.md\n\n# 国内六大电商平台流量机制与打法\n\n> 说明：本文为运营实操经验总结。平台算法与规则持续迭代，具体权重口径以\n> 各平台商家后台官方文档、规则中心公示为准。文中标注「经验值」的部分为\n> 行业普遍认知，非平台官方公布数据。\n\n---\n\n## 一、机制差异总览\n\n不同平台的底层逻辑决定了打法完全不同，照搬必死。\n\n| 平台 | 流量本质 | 用户心智 | 决定性指标 | 起量关键 |\n|------|---------|---------|-----------|---------|\n| 淘宝/天猫 | 搜索为主 + 推荐 | 有明确需求，货比三家 | 单坑产出（坑产） | 关键词卡位 + 人群标签 |\n| 京东 | 搜索为主 | 品质与时效优先 | 转化率 + 客单价 | 类目排名 + 物流时效 |\n| 拼多多 | 推荐为主 | 价格敏感，冲动下单 | 价格力 + 销量 | 活动坑位 + 低价冲量 |\n| 抖音 | 内容推荐 | 无明确需求，被激发 | GPM（千次观看成交额） | 内容点击率 + 转化效率 |\n| 小红书 | 内容搜索 + 推荐 | 决策前查攻略 | 笔记互动率 | 关键词种草 + 口碑沉淀 |\n| 视频号/微信小店 | 社交推荐 + 私域 | 信任驱动 | 复购率 | 私域沉淀 + 社交裂变 |\n\n**核心判断**：需求明确的标品去淘宝/京东/拼多多，需求需要被创造的\n非标品、新奇特产品去抖音/小红书。\n\n---\n\n## 二、淘宝 / 天猫\n\n### 搜索排序的权重构成（经验值）\n优先级从高到低：\n\n1. **类目相关性** —— 类目放错，后面全白搭。这是一票否决项。\n2. **文本相关性** —— 标题关键词与搜索词的匹配度\n3. **商品权重** —— 单坑产出（该关键词下的支付金额）、转化率、收藏加购率\n4. **店铺权重** —— 店铺层级、DSR 评分、退款率、纠纷率\n5. **个性化标签** —— 商品人群标签与搜索用户标签的匹配度\n\n**「坑产」是淘宝搜索的核心**：同一个关键词下，谁的支付金额高，谁排前面。\n所以刷低价单破坏的不只是转化率，更是把人群标签打乱。\n\n### 店铺层级\n按近 30 天支付金额分为 7 层。**跨层是流量分水岭**，同层商家互相竞争。\n卡在层级边缘时，冲一把跨层的收益远大于日常优化。\n\n### 标题规范\n- 天猫/淘宝标题上限 **30 个汉字（60 字符）**\n- 结构：`营销词 + 品牌词 + 核心词 + 属性词 + 长尾词`\n- 核心词必须放在能被完整切分的位置，避免关键词被拆散\n- 不留空格可提高字符利用率，但要保证可读性\n- 新品期用**精准长尾词**，有基础销量后再抢大词\n\n### 新品冷启动路径\n1. **0–7 天**：上架后打标（新品标），完善所有属性，主图/详情页做足\n2. **7–14 天**：用精准长尾词做基础销量 5–10 单 + 真实评价 + 买家秀\n3. **14–30 天**：直通车测图测款，跑出点击率高于行业均值的主图\n4. **30 天后**：有数据基础后放大投放，逐步抢中大词\n\n### 付费工具\n- **直通车（标准推广）** —— 关键词竞价，控词控人群，测款测图首选\n- **引力魔方** —— 人群定向，拉新与收割，适合推荐流量\n- **万相台无界** —— 智能化投放，托管出价，适合缺乏投放经验的商家\n\n---\n\n## 三、拼多多\n\n### 核心逻辑\n拼多多是**推荐流量为主**的平台，首页推荐占比远高于搜索。\n用户决策路径极短，价格力是第一位的。\n\n### 权重构成（经验值）\n`销量 + 转化率 + 价格力 + 服务分（DSR/发货时效/纠纷率）`\n\n**价格力**：平台会拿你的商品与全网同款比价，价格无优势直接失去推荐流量。\n\n### 起量路径\n1. 新品上架，先用**低价 + 低毛利**冲基础销量与评价\n2. 报名平台活动坑位：**限时秒杀、9块9特卖、百亿补贴**\n3. 活动带来的爆发销量会反哺自然推荐流量\n4. 有权重后再逐步调价，或用高毛利款承接流量\n\n### 推广工具\n- **搜索推广** —— 关键词竞价，意图明确\n- **场景推广** —— 推荐位竞价，走量核心\n- **明星店铺 / 全站推广** —— 智能投放\n\n**注意**：拼多多对**发货时效与售后**极其严格，延迟发货、虚假发货罚款重，\n\"仅退款\"政策对商家不友好，选品要充分考虑退货与纠纷成本。\n\n---\n\n## 四、抖音电商（兴趣电商）\n\n### 流量机制：赛马制\n内容发布后进入初始流量池（经验值约 300–500 曝光），\n系统根据数据表现决定是否推入下一级流量池。**层层赛马，逐级放大**。\n\n因此**前 500 次曝光的数据表现决定了这条内容的生死**。\n\n### 最核心指标：GPM\n```\nGPM = 成交金额 ÷ 曝光人数 × 1000\n```\n即\"每一千次观看能产生多少成交额\"。抖音判断是否给你更多流量，\n本质就是看你的流量变现效率，GPM 越高，系统越愿意给量。\n\n**提升 GPM 只有三条路**：提高点击率、提高转化率、提高客单价。\n\n### 短视频带货关键指标\n| 指标 | 参考基准（经验值） | 影响 |\n|------|-----------------|------|\n| 3 秒完播率 | > 45% | 决定是否继续推流 |\n| 完播率 | > 15% | 内容质量核心信号 |\n| 点击率（视频→商品） | > 3% | 挂车吸引力 |\n| 转化率 | > 3% | 商品详情承接力 |\n\n**黄金 3 秒**：前 3 秒必须给出冲突、痛点或结果，否则直接划走。\n\n### 直播间核心指标\n- **停留时长** —— 低于 30 秒说明开场话术或货品有问题\n- **互动率** —— 评论、点赞、加粉，影响推流\n- **UV 价值** = 成交额 ÷ 观看人数，直播间的\"坑产\"\n- **转化率** —— 场观到成交\n\n**直播节奏**：憋单引流 → 讲解产品 → 逼单成交 → 循环。\n每个循环 15–25 分钟，福利款引流、利润款赚钱、形象款拉高客单。\n\n### 付费工具：巨量千川\n- **随心推** —— 简易版，适合小额加热内容\n- **专业版-控成本投放** —— 设定成交出价，系统控制 CPA，稳定但量少\n- **专业版-放量投放** —— 不控成本，冲量用，风险高\n- **常见打法**：先用小额测素材，跑出高 CTR 素材后再放大投放\n\n### 达人分销\n通过**精选联盟**挂佣金，招募达人带货。\n佣金率通常设置在 **10%–30%**（另需支付平台技术服务费）。\n高佣金能吸引达人，但要先用 pricing.py 算清楚是否还有利润空间。\n\n---\n\n## 五、京东\n\n### 特点\n- 用户**购买意图明确**，客单价与转化率普遍高于其他平台\n- **物流时效是核心竞争力**，使用京东物流对搜索权重和转化都有正向影响\n- 3C 数码、家电品类优势明显\n\n### POP 店铺权重\n`销量 + 转化率 + 好评率 + 店铺星级（店铺评分）+ 物流时效`\n\n### 推广工具：京准通\n- **快车** —— 关键词竞价，等同直通车\n- **京东直投 / 购物触点** —— 站内展示位\n- **京挑客** —— 达人分销\n\n**注意**：京东有平台使用费和类目扣点，POP 店铺还有保证金要求，\n入驻门槛高于淘宝，但客单价与利润空间通常更好。\n\n---\n\n## 六、小红书\n\n### 平台本质\n**决策前的攻略平台**。用户在这里\"查作业\"，然后可能在小红书买，\n也可能去淘宝/天猫下单。所以小红书的价值不只是 GMV，更是**心智种草**。\n\n### 笔记权重：CES 评分（业内经验公式，官方未公开）\n```\nCES = 点赞×1 + 收藏×1 + 评论×4 + 转发×4 + 关注×8\n```\n**收藏与评论的价值远高于点赞**，因为它们代表\"真实有用\"。\n所以笔记结尾引导收藏（\"先码住\"）比引导点赞更有效。\n\n### 内容策略\n- 标题必须带**核心搜索关键词**，小红书搜索流量占比高\n- 正文自然植入关键词 3–5 次，结尾带 3–5 个精准话题标签\n- 封面图是点击率的决定因素，竖版 3:4，文字信息清晰\n- **真实感 > 精致感**，过度商业化的内容会被限流\n\n### 合规红线\n- 商业笔记必须通过**蒲公英平台**报备，否则会被判违规限流\n- 严禁**站外引流**（留微信、淘口令），轻则限流重则封号\n- 医美、保健品等类目有严格的内容限制\n\n### 变现路径\n1. 笔记种草 → 小红书商城闭环成交\n2. 笔记种草 → 用户去其他平台搜索品牌词下单（需做好品牌词承接）\n3. 买手直播带货\n\n---\n\n## 七、视频号 / 微信小店\n\n### 核心价值\n**社交推荐 + 私域沉淀**。依托微信生态，信任成本低，复购率高。\n\n### 打法\n- 公域：视频号内容推荐、直播广场\n- 私域：社群、朋友圈、公众号导流至小店\n- **社交裂变**：拼团、分享有礼在微信生态天然适配\n\n适合**高复购、需要信任背书**的品类（食品、母婴、健康、知识付费）。\n\n---\n\n## 八、跨平台通用铁律\n\n1. **不要照搬打法**。抖音的爆款视频思路搬到淘宝详情页会水土不服。\n2. **先算账再投流**。任何投放前先用 `pricing.py` 与 `ad_calc.py`\n   算出保本 ROI 与最高可承受 CPC，没有这两个数字就是在盲投。\n3. **人群标签一旦打乱，恢复成本极高**。低价冲量、非目标人群引流\n   会污染标签，导致后续精准流量失效。\n4. **合规先于增长**。所有对外文案先过 `compliance.py`，\n   广告法罚则起点二十万，一次翻车抵掉全年利润。\n5. **数据诊断优先于加预算**。转化链路有短板时加预算等于放大亏损，\n   先用 `diagnose.py` 定位瓶颈。\n\nFile v1.0.1:references/product-selection.md\n\n# 选品方法论与决策框架\n\n> 选品决定了 70% 的结果。运营能力只能放大选品的正确性，无法逆转错误的选品。\n\n---\n\n## 一、选品的四道门槛（顺序不可颠倒）\n\n任何一款产品，必须按顺序通过以下四关，前一关不过直接淘汰，不要留恋。\n\n### 第一关：合规关（一票否决）\n先确认能不能卖，再谈赚不赚钱。\n\n| 品类 | 强制要求 |\n|------|---------|\n| 3C 电子、儿童玩具、电器 | CCC 强制认证 |\n| 食品 | 食品经营许可证、SC 生产许可 |\n| 化妆品 | 化妆品备案凭证；美白/祛斑需「国妆特字」批文 |\n| 保健食品 | 蓝帽子批准文号 |\n| 医疗器械 | 一/二/三类医疗器械经营备案或许可 |\n| 图书音像 | 出版物经营许可证 |\n| 品牌商品 | 品牌授权书（缺失即侵权下架） |\n\n**知识产权排查**：外观专利、实用新型专利、商标、著作权。\n跨境或新奇特产品尤其容易踩专利雷，一封投诉信可能导致全店冻结。\n\n### 第二关：利润关\n用 `scripts/pricing.py` 实算，不要凭感觉。\n\n**判断标准（经验值）**：\n- 毛利率 **< 40%** —— 无法承担付费流量，只能靠自然流量，慎入\n- 毛利率 **40%–60%** —— 可做，但投放空间紧张，需精细化运营\n- 毛利率 **> 60%** —— 有充足投放空间，可以打爆款\n\n**必须算进去但最容易被忽略的成本**：\n去程运费、退货回程运费、包材、平台佣金、支付手续费、\n推广费、客服人力分摊、仓储分摊、坏账与损耗。\n\n### 第三关：需求关\n判断这个东西**到底有没有人要**。\n\n- **搜索型平台（淘宝/京东/拼多多）**：看关键词搜索指数与趋势。\n  搜索量持续下滑的品类不要进，那是在接盘。\n- **推荐型平台（抖音/小红书）**：看话题热度、同类内容互动量。\n  已经有内容跑出爆款说明需求被验证，完全没有内容的要警惕是伪需求。\n- **季节性判断**：提前 45–60 天布局。夏季品五月才上架已经晚了。\n\n### 第四关：竞争关\n```\n供需比 = 关键词搜索人气 ÷ 在售商品数\n```\n供需比越高说明需求大而供给少，机会越大。\n\n**竞争格局判断**：\n- 头部（TOP10）占据 80% 以上份额 → 垄断市场，新手勿入\n- 头部分散，长尾商家有销量 → 有机会切入\n- 全是白牌低价厮杀 → 除非有供应链成本优势，否则不进\n\n---\n\n## 二、选品评分模型\n\n用 `scripts/product_score.py` 量化打分，避免拍脑袋决策。\n六个维度，加权总分 100 分：\n\n| 维度 | 权重 | 评分要点 |\n|------|-----|---------|\n| 利润空间 | 25% | 毛利率高低，是否支撑投放 |\n| 市场需求 | 20% | 搜索量/内容热度及趋势方向 |\n| 竞争强度 | 20% | 供需比、头部集中度 |\n| 退货风险 | 15% | 品类退货率、尺码/色差问题 |\n| 物流成本 | 10% | 重量体积、易碎性、发货难度 |\n| 供应链 | 10% | 起订量、翻单速度、账期 |\n\n**决策阈值（经验值）**：\n- **≥ 75 分** —— 优质款，可重点投入资源打造\n- **60–74 分** —— 可做款，小批量测试后再决定\n- **< 60 分** —— 放弃，机会成本太高\n\n---\n\n## 三、按退货率划分的品类风险\n\n退货率是国内电商最容易被低估的利润杀手，尤其在抖音等冲动消费场景。\n\n| 品类 | 退货率参考区间（经验值） | 主要原因 |\n|------|----------------------|---------|\n| 服饰鞋帽 | 30%–50%（直播可达 60%+） | 尺码、色差、版型预期落差 |\n| 美妆护肤 | 10%–20% | 肤感不符、过敏 |\n| 3C 数码 | 5%–15% | 参数不符、质量问题 |\n| 家居日用 | 10%–20% | 尺寸不符、材质预期 |\n| 食品生鲜 | 5%–15% | 物流损耗、口味 |\n| 图书文具 | 3%–8% | 相对最低 |\n\n**关键**：服饰类在抖音直播场景退货率可能超过 50%，\n用 `pricing.py --return-rate 50` 算一下，很多\"爆单\"其实是巨亏。\n\n---\n\n## 四、产品结构：四种角色缺一不可\n\n单靠一款产品无法支撑店铺，必须搭建产品矩阵。\n\n1. **引流款**（占比 20%）\n   低价高需求，用于获取流量与新客，毛利可接近于零，甚至微亏。\n   考核指标是**引流效率**（UV 成本），不是利润。\n\n2. **利润款**（占比 30%）\n   店铺的现金流来源，毛利率 60% 以上，靠引流款带来的流量承接转化。\n   考核指标是**利润额**。\n\n3. **形象款**（占比 10%）\n   高客单、高品质，拉高店铺整体调性与客单价，销量不高但不可缺。\n   考核指标是**客单价拉升**。\n\n4. **狙击款**（占比 40%）\n   对标竞品的同款或改良款，用于抢占竞品流量，价格与卖点针对性设计。\n   考核指标是**市场份额**。\n\n---\n\n## 五、供应链与备货\n\n### 供应商评估要点\n- **起订量（MOQ）** —— 首单不要压太多货，测款期用小单快反\n- **翻单速度** —— 爆款出现后能否 7 天内补货，这决定能否吃到红利\n- **账期** —— 现结还是月结，直接影响资金周转\n- **质检能力** —— 次品率高会推高退货率，摧毁店铺权重\n- **是否支持一件代发** —— 起步期降低库存风险\n\n### 备货公式\n```\n安全库存 = 日均销量 × 补货周期天数 × (1 + 安全系数)\n建议备货量 = 预估日销 × 备货天数 - 现有库存 - 在途库存\n```\n安全系数一般取 **0.2–0.5**，大促期间取上限。\n\n**备货铁律**：\n- 新品测试期：只备**7–15 天**销量，宁可断货也不要压死资金\n- 稳定期：备**20–30 天**销量\n- 大促前：按预估峰值备货，但要留好尾货处理方案\n- **季节性商品必须在季末前清空**，压到下一年的库存基本等于亏损\n\n---\n\n## 六、常见选品陷阱\n\n1. **自嗨式选品** —— \"我觉得这个好\"。市场数据才是唯一依据。\n2. **只看销量不看利润** —— 卖爆了却在亏钱，是最常见的死法。\n3. **忽略退货率** —— 服饰类尤其致命，退货率算错一切归零。\n4. **忽略专利与授权** —— 尤其是新奇特产品与品牌周边。\n5. **盲目跟风爆款** —— 你看到爆款时，红利期通常已过，\n   且价格战已经开始，此时入场是接盘。\n6. **供应链没谈好就推爆款** —— 推爆了补不上货，权重掉光，得不偿失。\n\nFile v1.0.1:skill-card.md\n\n## Description:\n\nA Chinese ecommerce operations skill that helps agents evaluate products, calculate pricing and advertising ROI, diagnose conversion funnels, check promotional copy for advertising-law risk, and consult platform operations playbooks.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[g305595965](https://clawhub.ai/user/g305595965)\n\n### License/Terms of Use:\n\nMIT\n\n## Use Case:\n\nExternal users and ecommerce operators use this skill to support Chinese marketplace decisions across product selection, pricing, paid traffic, conversion diagnosis, listing content, live commerce, and compliance review. Agents can call local calculators and consult reference playbooks to produce decision support, markdown guidance, shell commands, code-oriented tool usage, and JSON-formatted calculations.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Platform fees, benchmark ranges, and legal-compliance checks may be incomplete or outdated for current Chinese ecommerce platforms and regulations.\n\nMitigation: Treat outputs as decision support and verify important values against current platform merchant dashboards, official platform notices, and qualified regulatory or legal sources before acting.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/g305595965/skills/cn-ecommerce-ops)\n- [Publisher profile](https://clawhub.ai/user/g305595965)\n- [README](README.md)\n- [Listing and content playbook](references/listing-and-content.md)\n- [Operations playbook](references/operations-playbook.md)\n- [Platform playbook](references/platform-playbook.md)\n- [Product selection playbook](references/product-selection.md)\n\n## Skill Output:\n\n**Output Type(s):** [Guidance, Markdown, Code, Shell commands, Configuration, Text]\n\n**Output Format:** [Markdown and text with inline shell commands, plus optional JSON from local Python calculators]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Calculator scripts use Python 3 standard library and support --json output and --self-test modes.]\n\n## Skill Version(s):\n\n1.0.1 (source: server release metadata and SKILL.md frontmatter)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.0.1:LICENSE\n\nMIT License\n\nCopyright (c) 2026 g305595965\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\nArchive v1.0.0: 17 files, 2763688 bytes\n\nFiles: assets/demo.gif (2923122b), LICENSE (1067b), README.md (6984b), references/listing-and-content.md (7524b), references/operations-playbook.md (7991b), references/platform-playbook.md (9588b), references/product-selection.md (6444b), scripts/ad_calc.py (11720b), scripts/compliance.py (15008b), scripts/diagnose.py (12096b), scripts/platform_fees.py (4678b), scripts/pricing.py (13642b), scripts/product_score.py (13926b), skill-card.md (3072b), SKILL.md (10611b), tests/run_all.py (9018b), _meta.json (135b)\n\nFile v1.0.0:SKILL.md\n\n---\r\nname: cn-ecommerce-ops\r\nversion: 1.0.0\r\ndescription: 国内电商全链路运营专家技能，覆盖淘宝、天猫、京东、拼多多、抖音电商、小红书、视频号六大平台。提供选品评分、定价与利润测算、广告投放ROI测算、店铺转化漏斗诊断、广告法违禁词合规检查五个可执行工具，以及平台流量机制、选品方法论、标题主图详情页优化、直播短视频、运营节奏与风控的完整知识库。当用户涉及国内电商选品、定价、算利润、算ROI、投直通车或千川、做店铺诊断、优化标题主图详情页、写商品文案、直播运营、检查文案是否违反广告法、平台规则与流量玩法等问题时，应使用本技能。\r\nauthor: g305595965\r\nrepository: https://github.com/g305595965/cn-ecommerce-ops\r\nlicense: MIT\r\ntags:\r\n  - 电商\r\n  - 国内电商\r\n  - 淘宝\r\n  - 天猫\r\n  - 京东\r\n  - 拼多多\r\n  - 抖音电商\r\n  - 小红书\r\n  - 视频号\r\n  - 选品\r\n  - 定价\r\n  - 利润\r\n  - ROI\r\n  - 广告投放\r\n  - 漏斗诊断\r\n  - 广告法\r\n  - 合规\r\ntriggers:\r\n  - 国内电商\r\n  - 电商运营\r\n  - 定价测算\r\n  - 利润计算\r\n  - 保本价\r\n  - 广告ROI\r\n  - 投放ROI\r\n  - 转化漏斗\r\n  - 漏斗诊断\r\n  - 选品评分\r\n  - 广告法违禁词\r\n  - 极限词检查\r\n  - 淘宝运营\r\n  - 抖音电商\r\n  - 小红书运营\r\nagent_created: true\r\n---\r\n\r\n# 国内电商全链路运营\r\n\r\n## 概述\r\n\r\n本技能把国内电商运营中最依赖经验判断的环节，转化为可计算、可复核的\r\n决策流程。核心主张是：**先算账，再做事**。\r\n\r\n多数电商决策失误源于三件事——不算真实利润（漏算退货与推广成本）、\r\n不算保本 ROI（盲目投放）、不查合规（广告法罚则起点二十万元）。\r\n本技能为这三件事各提供了确定性工具。\r\n\r\n## 何时使用\r\n\r\n在遇到以下任一场景时使用本技能：\r\n\r\n- 判断某款产品值不值得做（选品评估、竞品分析）\r\n- 定价、核算真实利润、计算保本售价\r\n- 投放前测算保本 ROI、可承受最高出价、目标 ROI 反推\r\n- 店铺流量正常但不出单、转化率下滑、ROI 做不上去\r\n- 撰写或审核商品标题、主图文案、详情页、短视频脚本、直播话术\r\n- 检查文案是否触碰广告法违禁词与极限词\r\n- 了解淘宝/天猫/京东/拼多多/抖音/小红书的流量机制与冷启动打法\r\n- 制定日常运营节奏、大促排期、备货计划\r\n\r\n## 快速路由\r\n\r\n根据用户问题类型，选择对应工具或文档：\r\n\r\n| 用户问题类型 | 使用 |\r\n|------------|------|\r\n| 这个品能不能做 | `scripts/product_score.py` + `references/product-selection.md` |\r\n| 卖多少钱／能赚多少／保本价 | `scripts/pricing.py` |\r\n| 广告怎么投／ROI 多少才不亏／出价多少 | `scripts/ad_calc.py` |\r\n| 有流量不出单／哪个环节有问题 | `scripts/diagnose.py` |\r\n| 文案能不能这么写／会不会违规 | `scripts/compliance.py` |\r\n| 平台怎么起量／算法逻辑 | `references/platform-playbook.md` |\r\n| 标题主图详情页／短视频／直播 | `references/listing-and-content.md` |\r\n| 日常怎么做／大促怎么排／怎么防违规 | `references/operations-playbook.md` |\r\n\r\n## 可执行工具\r\n\r\n全部脚本使用 Python 3 标准库，无第三方依赖，可直接运行。\r\n所有脚本均支持 `--json` 输出结构化结果，支持 `--self-test` 自检。\r\n运行前先切换到 `scripts/` 目录，或确保该目录在 `PYTHONPATH` 中。\r\n\r\n### 1. 定价与利润测算 —— pricing.py\r\n\r\n采用 100 单基准法核算，把退货造成的去程运费、包材、损耗全部计入，\r\n这是\"卖爆了却在亏钱\"的根本原因。\r\n\r\n```bash\r\npython scripts/pricing.py --cost 35 --price 129 --platform douyin \\\r\n    --shipping 4.5 --packaging 1.5 --return-rate 30 --ad-ratio 18\r\n```\r\n\r\n输出单均净利、净利率、毛利率、**保本售价**、**保本 ROI** 与成本结构。\r\n`--list-platforms` 查看内置平台费率参考表。\r\n\r\n**关键用法**：在任何定价、报价、谈达人佣金、参加活动前先跑一次。\r\n得到的\"保本售价\"是价格底线，\"保本 ROI\"是投放的生死线。\r\n\r\n### 2. 投放测算 —— ad_calc.py\r\n\r\n适用于直通车、万相台、巨量千川、京准通、多多推广等所有 CPC 场景。\r\n\r\n```bash\r\npython scripts/ad_calc.py --price 129 --gross-margin 60 --cvr 2.5 --cpc 1.2 \\\r\n    --budget 2000 --target-roi 4\r\n```\r\n\r\n输出 UV 价值、当前 ROI、保本 ROI、**可承受最高 CPC**、CPA、\r\n日预算测算，以及达成目标 ROI 所需的 CPC 或转化率（二选一路径）。\r\n\r\n**核心恒等式**：`ROI = UV价值 ÷ CPC`，`保本ROI = 1 ÷ 毛利率`。\r\n毛利率参数应使用 `pricing.py` 算出的毛利率，两个工具串联使用。\r\n\r\n### 3. 转化漏斗诊断 —— diagnose.py\r\n\r\n不看哪个数字低，而是看**哪个环节相对行业基准差得最多**，\r\n偏离最大的环节即为瓶颈，优先修复它的投入产出比最高。\r\n\r\n```bash\r\npython scripts/diagnose.py --impression 200000 --click 2000 --cart 200 \\\r\n    --order 110 --paid 55 --refund 8 --gmv 6600\r\n```\r\n\r\n输出各环节转化率与基准对比、瓶颈定位、按优先级排序的处方，\r\n以及\"瓶颈修复到基准后订单能涨多少\"的提升模拟。\r\n\r\n**使用原则**：转化链路存在短板时加预算等于放大亏损，先诊断再投放。\r\n\r\n### 4. 选品六维评分 —— product_score.py\r\n\r\n利润空间 25%、市场需求 20%、竞争强度 20%、退货风险 15%、\r\n物流成本 10%、供应链 10%，加权总分 100。\r\n\r\n```bash\r\npython scripts/product_score.py --gross-margin 62 --search-index 8000 \\\r\n    --trend up --supply-ratio 3.2 --return-rate 18 --weight 0.4 \\\r\n    --moq 100 --restock-days 10\r\n```\r\n\r\n输出总分、各维度得分、短板识别与改进方向。\r\n阈值：≥75 优质款，60–74 可做款小批量测试，<60 建议放弃。\r\n\r\n### 5. 合规检查 —— compliance.py\r\n\r\n内置 175 条广告法违禁词库，分三级风险：\r\nP0 明令禁止（绝对化用语，命中即违法）、P1 需要资质、P2 真实性约束。\r\n\r\n```bash\r\npython scripts/compliance.py --text \"全网最低价，销量第一\"\r\npython scripts/compliance.py --file detail.txt --min-level P0\r\n```\r\n\r\n输出命中词、风险级别、原文上下文与整改建议。\r\n**命中 P0 时进程返回码为 1**，可用于批处理或 CI 流程拦截。\r\n\r\n**强制要求**：所有对外文案（标题、主图文字、详情页、短视频脚本、\r\n直播话术、客服话术）发布前必须扫描，P0 必须清零。\r\n\r\n## 知识库\r\n\r\n需要方法论、平台规则或实操细节时，按需读取以下文档：\r\n\r\n- **`references/platform-playbook.md`** —— 六大平台流量机制对比、\r\n  淘宝搜索权重与坑产逻辑、拼多多价格力与活动起量、抖音赛马机制与 GPM、\r\n  京东与小红书打法、跨平台通用铁律。\r\n- **`references/product-selection.md`** —— 选品四道门槛（合规/利润/\r\n  需求/竞争）、评分模型说明、分品类退货率参考、四种产品角色矩阵、\r\n  供应链评估与备货公式、六大选品陷阱。\r\n- **`references/listing-and-content.md`** —— 各平台标题字数与结构公式、\r\n  主图五图法则、详情页九屏黄金结构、短视频脚本框架、直播节奏与货盘、\r\n  评价运营、发布前检查清单。\r\n- **`references/operations-playbook.md`** —— GMV 公式拆解、核心指标\r\n  定义与健康区间、日周月运营节奏、提升客单价六法、大促五阶段节奏、\r\n  售后与差评处理、平台与法律风控红线、常见问题速查。\r\n\r\n## 典型工作流\r\n\r\n### 工作流 A：评估一个新品能不能做\r\n\r\n1. 用 `product_score.py` 做六维评分，得到初步结论\r\n2. 若 ≥60 分，用 `pricing.py` 精算利润，确认保本售价与毛利率\r\n3. 用 `ad_calc.py` 代入毛利率，算出保本 ROI 与最高可承受 CPC\r\n4. 判断该 CPC 在目标类目是否可实现（对比行业平均 CPC）\r\n5. 读 `references/product-selection.md` 核对合规资质与供应链风险\r\n6. 输出结论：做 / 不做 / 小批量测试，并给出价格与投放边界\r\n\r\n### 工作流 B：店铺有流量但不出单\r\n\r\n1. 用 `diagnose.py` 输入完整漏斗数据，定位瓶颈环节\r\n2. 按输出的处方逐条执行，不要跳过优先级\r\n3. 若瓶颈在点击率 → 读 `listing-and-content.md` 主图章节\r\n4. 若瓶颈在转化率 → 读详情页九屏结构与评价运营章节\r\n5. 若瓶颈在支付率 → 检查运费门槛、优惠券、库存与催付\r\n6. 修复后重新跑 `diagnose.py` 对比验证\r\n\r\n### 工作流 C：投放亏损，ROI 做不上去\r\n\r\n1. 用 `pricing.py` 确认真实毛利率（多数人此处高估）\r\n2. 用 `ad_calc.py` 算保本 ROI，与实际 ROI 对比\r\n3. 若实际 ROI < 保本 ROI，用 `--target-roi` 反推需要的 CPC 或转化率\r\n4. 优先级固定为：提转化率 > 降 CPC > 提客单价\r\n5. 转化率问题回到工作流 B 做漏斗诊断\r\n\r\n### 工作流 D：撰写或审核商品文案\r\n\r\n1. 读 `references/listing-and-content.md` 对应章节获取结构模板\r\n2. 按平台字数限制与结构公式撰写\r\n3. 用 `compliance.py` 扫描，P0 必须清零，P1 确认资质，P2 确认可举证\r\n4. 对照文档末尾的发布前检查清单逐项确认\r\n\r\n## 铁律\r\n\r\n1. **先算账，再做事。** 定价、投放、报活动、谈佣金之前，\r\n   必须先跑 `pricing.py` 和 `ad_calc.py`，没有保本售价与保本 ROI\r\n   这两个数字就是在盲目决策。\r\n2. **诊断优先于加预算。** 转化链路有短板时加预算只会放大亏损。\r\n3. **合规先于增长。** 广告法罚则起点二十万元，一次翻车抵掉全年利润。\r\n   所有对外文案先过 `compliance.py`。\r\n4. **不照搬跨平台打法。** 抖音的内容逻辑与淘宝的搜索逻辑完全不同。\r\n5. **数据以商家后台为准。** 本技能内置的费率、行业基准均为公开参考值，\r\n   实际决策必须用后台真实数据校准。\r\n6. **不编造数据。** 无法确认的数字应明确说明其为估算或参考区间，\r\n   并提示用户核实来源。\r\n\r\n## 免责声明\r\n\r\n本技能提供的费率、行业基准、退货率区间等均为公开信息与行业经验值，\r\n平台规则持续变化，使用前须以各平台官方最新公示为准。\r\n合规检查结果为风险自查提示，不构成法律意见，\r\n具体认定以市场监管部门为准。\n\nFile v1.0.0:README.md\n\n# 国内电商全链路运营 Skill（cn-ecommerce-ops）\n\n![使用演示](assets/demo.gif)\n\n一个面向 AI Agent 的**国内电商运营专家技能包**，覆盖淘宝、天猫、京东、\n拼多多、抖音电商、小红书、视频号六大平台。\n\n核心主张只有一句：**先算账，再做事。**\n\n多数电商决策失误来自三件事——不算真实利润（漏算退货与推广成本）、\n不算保本 ROI（盲目投放）、不查合规（广告法罚则起点二十万元）。\n本技能为这三件事各提供了一个可执行、可验证的确定性工具。\n\n![tests](https://img.shields.io/badge/tests-34%20passed-brightgreen)\n![python](https://img.shields.io/badge/python-3.9%2B-blue)\n![deps](https://img.shields.io/badge/dependencies-none-lightgrey)\n![license](https://img.shields.io/badge/license-MIT-green)\n![stars](https://img.shields.io/github/stars/g305595965/cn-ecommerce-ops?style=social)\n![forks](https://img.shields.io/github/forks/g305595965/cn-ecommerce-ops?style=social)\n![issues](https://img.shields.io/github/issues/g305595965/cn-ecommerce-ops)\n\n---\n\n## 为什么需要它\n\n大模型对电商的了解通常停留在\"多做内容、优化主图、提升转化率\"这类\n正确但无用的建议。真正的运营决策需要的是**数字**：\n\n- 这个价格到底赚不赚钱？退货率 30% 之后还剩多少？\n- 投放 ROI 做到多少才不亏？最高能出多少钱一个点击？\n- 有流量不出单，问题到底出在哪一环？\n- 这句文案会不会让我被罚二十万？\n\n本技能把这些问题变成可以直接算出答案的命令。\n\n---\n\n## 五个可执行工具\n\n全部使用 Python 3 标准库实现，**零第三方依赖**，每个脚本都内置自检。\n\n| 脚本 | 作用 | 关键输出 |\n|------|------|---------|\n| `scripts/pricing.py` | 定价与利润测算 | 单均净利、**保本售价**、**保本 ROI**、成本结构 |\n| `scripts/ad_calc.py` | 付费投放测算 | UV 价值、**可承受最高 CPC**、目标 ROI 反推 |\n| `scripts/diagnose.py` | 转化漏斗诊断 | 瓶颈环节定位、优先级处方、提升模拟 |\n| `scripts/product_score.py` | 选品六维评分 | 综合得分、短板识别与改进方向 |\n| `scripts/compliance.py` | 广告法合规检查 | 175 条违禁词库，三级风险分级与整改建议 |\n\n### 亮点设计\n\n**1. 定价用 100 单基准法，而不是简单减法**\n\n退货产生的去程运费、包材、损耗都不可回收，这是\"卖爆了却在亏钱\"的\n根本原因。脚本模拟发出 100 单、其中 r% 退货，分别核算收入与成本，\n再折算回单均利润。\n\n```bash\npython scripts/pricing.py --cost 35 --price 129 --platform douyin \\\n    --shipping 4.5 --packaging 1.5 --return-rate 30 --ad-ratio 18\n```\n\n**2. 诊断看的是相对基准的偏离度，不是绝对值高低**\n\n哪个环节相对行业基准差得最多，哪个才是真瓶颈，修复它的投入产出比最高。\n\n```bash\npython scripts/diagnose.py --impression 200000 --click 2000 \\\n    --order 110 --paid 55 --gmv 6600\n```\n\n```\n  [!]  点击率         1.00%  基准 2.0~5.0%    偏低 偏离 50.0%\n  [OK] 下单率         5.50%  基准 3.0~8.0%    正常\n  [!]  支付率        50.00%  基准 60.0~85.0%  偏低 偏离 16.7%\n\n--- 瓶颈定位 ---\n  最大瓶颈: 曝光 -> 点击（点击率）\n  可能归因: 主图/短视频首帧、标题、价格带、人群精准度\n```\n\n**3. 合规检查可接入自动化流程**\n\n命中 P0（广告法明令禁止的绝对化用语）时进程返回码为 `1`，\n可直接用于批处理或 CI 拦截。\n\n```bash\npython scripts/compliance.py --file detail.txt --min-level P0\n```\n\n---\n\n## 四册知识库\n\n| 文档 | 内容 |\n|------|------|\n| `references/platform-playbook.md` | 六大平台流量机制对比、淘宝坑产逻辑、拼多多价格力、抖音赛马与 GPM、小红书 CES、冷启动路径 |\n| `references/product-selection.md` | 选品四道门槛、分品类退货率参考、四种产品角色矩阵、供应链评估与备货公式 |\n| `references/listing-and-content.md` | 标题结构公式、主图五图法则、详情页九屏结构、短视频脚本框架、直播节奏与货盘 |\n| `references/operations-playbook.md` | GMV 公式拆解、指标健康区间、日周月节奏、大促五阶段、风控红线速查 |\n\n---\n\n## 安装\n\n### WorkBuddy\n\n```bash\ngit clone https://github.com/g305595965/cn-ecommerce-ops.git ~/.workbuddy/skills/cn-ecommerce-ops\n```\n\n### Claude Code\n\n```bash\ngit clone https://github.com/g305595965/cn-ecommerce-ops.git ~/.claude/skills/cn-ecommerce-ops\n```\n\n### 手动安装\n\n下载仓库 ZIP，解压后将整个目录放入对应的 `skills/` 目录，\n确保目录内直接包含 `SKILL.md`。\n\n安装后重启客户端，向 AI 提问\"帮我算一下这个品能不能做\"即可自动触发。\n\n---\n\n## 直接当命令行工具用\n\n不依赖任何 AI 客户端，脚本本身就是完整的命令行工具：\n\n```bash\ncd scripts\n\n# 查看内置平台费率参考表\npython pricing.py --list-platforms\n\n# 算保本 ROI 和最高出价\npython ad_calc.py --price 129 --gross-margin 60 --cvr 2.5 --cpc 1.2 --target-roi 4\n\n# 选品评分\npython product_score.py --gross-margin 62 --search-index 8000 --trend up \\\n    --supply-ratio 3.2 --return-rate 18 --weight 0.4 --moq 100 --restock-days 10\n\n# 导出完整违禁词库\npython compliance.py --list-rules\n```\n\n所有脚本均支持 `--json` 输出结构化结果，方便二次开发与集成。\n\n---\n\n## 测试\n\n```bash\npython tests/run_all.py\n```\n\n三层验证，共 34 项：\n\n- **L1 单元层** —— 逐个运行各脚本内置自检（含公式自洽、单调性、异常拦截）\n- **L2 集成层** —— 验证工具链数据自洽，例如 `pricing.py` 与 `ad_calc.py`\n  两个独立脚本算出的保本 ROI 必须一致、保本售价代回后净利必须归零\n- **L3 结构层** —— 校验 SKILL.md 元数据、文件完整性，\n  以及文档中引用的每一个脚本路径是否真实存在（防止文档说谎）\n\n---\n\n## 数据来源与免责声明\n\n- 内置的平台费率、行业转化基准、分品类退货率均为**公开信息与行业经验值**，\n  文中已逐项标注。平台规则持续变化，实际决策**必须以各平台商家后台\n  最新公示为准**。\n- 合规检查基于《广告法》（2021 修正）第九条等条款及常","readmeExcerpt":"Skill: 国内电商全链路运营 Owner: g305595965 Summary: 国内电商全链路运营专家技能，覆盖淘宝、天猫、京东、拼多多、抖音电商、小红书、视频号、Temu八大平台。提供选品评分、定价与利润测算（含达人佣金）、广告投放ROI测算、店铺转化漏斗诊断、广告法违禁词合规检查、商品标题生成、备货与资金占用测算七个可计算工具，以及一个实时数据桥接器(live.py)——先用 WebSearch/WebFetch 拉取当前真实佣金率、类目退货率、1688进货价、关键词搜索量，再一键灌入各计算器，实现\"实时可用\"的决策。当用户涉及国内电商选品、定价、算利润、算ROI、投直通车或千川、做店铺诊断、写商品标题、算备货量、优化标题主图详情页、写商品文案、直播运营、检查文案是否违反广告法、Temu全托管半托管报价与合规、平台规则与流量玩法，或需要查最新费率/获取实时行情来辅助决策时，应使用本技能。 Tags: ROI:1.0.","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"python scripts/pricing.py --cost 35 --price 129 --platform douyin \\\n    --shipping 4.5 --packaging 1.5 --return-rate 30 --ad-ratio 18"},{"language":"bash","snippet":"python scripts/ad_calc.py --price 129 --gross-margin 60 --cvr 2.5 --cpc 1.2 \\\n    --budget 2000 --target-roi 4"},{"language":"bash","snippet":"python scripts/diagnose.py --impression 200000 --click 2000 --cart 200 \\\n    --order 110 --paid 55 --refund 8 --gmv 6600"},{"language":"bash","snippet":"python scripts/product_score.py --gross-margin 62 --search-index 8000 \\\n    --trend up --supply-ratio 3.2 --return-rate 18 --weight 0.4 \\\n    --moq 100 --restock-days 10"},{"language":"bash","snippet":"python scripts/compliance.py --text \"全网最低价，销量第一\"\npython scripts/compliance.py --file detail.txt --min-level P0"},{"language":"bash","snippet":"python scripts/title_gen.py --core \"汽车LED大灯\" \\\n    --attrs \"激光,双铜管,IP68,H7\" --scenes \"货车,夜行\" --platform pdd --n 5"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: cn-ecommerce-ops\nversion: 1.2.1\ndescription: 国内电商全链路运营专家技能，覆盖淘宝、天猫、京东、拼多多、抖音电商、小红书、视频号、Temu八大平台。提供选品评分、定价与利润测算（含达人佣金）、广告投放ROI测算、店铺转化漏斗诊断、广告法违禁词合规检查、商品标题生成、备货与资金占用测算七个可计算工具，以及一个实时数据桥接器(live.py)——先用 WebSearch/WebFetch 拉取当前真实佣金率、类目退货率、1688进货价、关键词搜索量，再一键灌入各计算器，实现\"实时可用\"的决策。当用户涉及国内电商选品、定价、算利润、算ROI、投直通车或千川、做店铺诊断、写商品标题、算备货量、优化标题主图详情页、写商品文案、直播运营、检查文案是否违反广告法、Temu全托管半托管报价与合规、平台规则与流量玩法，或需要查最新费率/获取实时行情来辅助决策时，应使用本技能。\nauthor: g305595965\nrepository: https://github.com/g305595965/cn-ecommerce-ops\nlicense: MIT\ntags:\n  - 电商\n  - 国内电商\n  - 淘宝\n  - 天猫\n  - 京东\n  - 拼多多\n  - 抖音电商\n  - 小红书\n  - 视频号\n  - 选品\n  - 定价\n  - 利润\n  - ROI\n  - 广告投放\n  - 漏斗诊断\n  - 广告法\n  - 合规\n  - Temu\n  - 跨境电商\n  - 标题生成\n  - 备货\ntriggers:\n  - 国内电商\n  - 电商运营\n  - 定价测算\n  - 利润计算\n  - 保本价\n  - 广告ROI\n  - 投放ROI\n  - 转化漏斗\n  - 漏斗诊断\n  - 选品评分\n  - 广告法违禁词\n  - 极限词检查\n  - 淘宝运营\n  - 抖音电商\n  - 小红书运营\n  - 实时费率\n  - 实时行情\n  - 查最新佣金\n  - 1688进货价\n  - 关键词搜索量\n  - 数据以实时为准\n  - Temu\n  - 全托管\n  - 半托管\n  - 跨境电商\n  - 标题怎么写\n  - 商品标题\n  - 备货量\n  - 补货点\n  - 库存测算\n  - 达人佣金\nagent_created: true\n---\n\n# 国内电商全链路运营\n\n## 概述\n\n本技能把国内电商运营中最依赖经验判断的环节，转化为可计算、可复核的\n决策流程。核心主张是：**先算账，再做事**。\n\n多数电商决策失误源于三件事——不算真实利润（漏算退货与推广成本）、\n不算保本 ROI（盲目投放）、不查合规（广告法罚则起点二十万元）。\n本技能为这三件事各提供了确定性工具。\n\n## 何时使用\n\n在遇到以下任一场景时使用本技能：\n\n- 判断某款产品值不值得做（选品评估、竞品分析）\n- 定价、核算真实利润、计算保本售价\n- 投放前测算保本 ROI、可承受最高出价、目标 ROI 反推\n- 店铺流量正常但不出单、转化率下滑、ROI 做不上去\n- 撰写或审核商品标题、主图文案、详情页、短视频脚本、直播话术\n- 检查文案是否触碰广告法违禁词与极限词\n- 了解淘宝/天猫/京东/拼多多/抖音/小红书的流量机制与冷启动打法\n- 制定日常运营节奏、大促排期、备货计划\n\n## 快速路由\n\n根据用户问题类型，选择对应工具或文档：\n\n| 用户问题类型 | 使用 |\n|------------|------|\n| 这个品能不能做 | `scripts/product_score.py` + `references/product-selection.md` |\n| 卖多少钱／能赚多少／保本价／达人佣金怎么算 | `scripts/pricing.py` |\n| 广告怎么投／ROI 多少才不亏／出价多少 | `scripts/ad_calc.py` |\n| 有流量不出单／哪个环节有问题 | `scripts/diagnose.py` |\n| 文案能不能这么写／会不会违规 | `scripts/compliance.py` |\n| 标题怎么写／批量出标题候选 | `scripts/title_gen.py` + `references/listing-and-content.md` |\n| 备多少货／会不会断货／压多少资金 | `scripts/inventory.py` |\n| 给我实时费率/进货价/搜索量再算 | `scripts/live.py`（先 `sources`/`schema` 拉数据，再 `plan` 灌入计算器） |\n| 平台怎么起量／算法逻辑 | `references/platform-playbook.md` |\n| 标题主图详情页／短视频／直播 | `references/listing-and-content.md` |\n| 日常怎么做／大促怎么排／怎么防违规 | `references/operations-playbook.md` |\n| Temu 全托管半托管／跨境报价与合规 | `references/crossborder-temu.md` |\n\n## 可执行工具\n\n全部脚本使用 Python 3 标准库，无第三方依赖，可直接运行。\n所有脚本均支持 `--json` 输出结构化结果，支持 `--self-test` 自检。\n运行前先切换到 `scripts/` 目录，或确保该目录在 `PYTHONPATH` 中。\n\n### 1. 定价与利润测算 —— pricing.py\n\n采用 100 单基准法核算，把退货造成的去程运费、包材、损耗全部计入，\n这是\"卖爆了却在亏钱\"的根本原因。\n\n```bash\npython scripts/pricing.py --cost 35 --price 129 --platform douyin \\\n    --shipping 4.5 --packaging 1.5 --return-rate 30 --ad-ratio 18\n```\n\n输出单均净利、净利率、毛利率、**保本售价**、**保本 ROI** 与成本结构。\n`--list-platforms` 查看内置平台费率参考表（含 Temu）。\n抖音/快手/视频号带货场景用 `--daren-ratio` 计入达人/分销佣金\n（按有效成交额计，退款单佣金退回）。\n\n**关键用法**：在任何定价、报价、谈达人佣金、参加活动前先跑一次。\n得到的\"保本售价\"是价格底线，\"保本 ROI\"是投放的生死线。\n\n### 2. 投放测算 —— ad_calc.py\n\n适用于直通车、万相台、巨量千川、京准通、多多推广等所有 CPC 场景。\n\n```bash\npython scripts/ad_calc.py --price 129 --gross-margin 60 --cvr 2.5 --cpc 1.2 \\\n    --budget 2000 --target-roi 4\n```\n\n输出 UV 价值、当前 ROI、保本 ROI、**可承受最高 CPC**、CPA、\n日预算测算，以及达"},{"path":"README.md","content":"# 国内电商全链路运营 Skill（cn-ecommerce-ops）\n\n![使用演示](assets/demo.gif)\n\n一个面向 AI Agent 的**国内电商运营专家技能包**，覆盖淘宝、天猫、京东、\n拼多多、抖音电商、小红书、视频号七大国内平台及 Temu 跨境。\n\n核心主张只有一句：**先算账，再做事。**\n\n多数电商决策失误来自三件事——不算真实利润（漏算退货与推广成本）、\n不算保本 ROI（盲目投放）、不查合规（广告法罚则起点二十万元）。\n本技能为这三件事各提供了一个可执行、可验证的确定性工具。\n\n![tests](https://img.shields.io/badge/tests-48%20passed-brightgreen)\n![python](https://img.shields.io/badge/python-3.9%2B-blue)\n![deps](https://img.shields.io/badge/dependencies-none-lightgrey)\n![license](https://img.shields.io/badge/license-MIT-green)\n![stars](https://img.shields.io/github/stars/g305595965/cn-ecommerce-ops?style=social)\n![forks](https://img.shields.io/github/forks/g305595965/cn-ecommerce-ops?style=social)\n![issues](https://img.shields.io/github/issues/g305595965/cn-ecommerce-ops)\n\n---\n\n## 为什么需要它\n\n大模型对电商的了解通常停留在\"多做内容、优化主图、提升转化率\"这类\n正确但无用的建议。真正的运营决策需要的是**数字**：\n\n- 这个价格到底赚不赚钱？退货率 30% 之后还剩多少？\n- 投放 ROI 做到多少才不亏？最高能出多少钱一个点击？\n- 有流量不出单，问题到底出在哪一环？\n- 这句文案会不会让我被罚二十万？\n\n本技能把这些问题变成可以直接算出答案的命令。\n\n---\n\n## 七个可执行工具 + 实时数据桥接\n\n全部使用 Python 3 标准库实现，**零第三方依赖**，每个脚本都内置自检。\n\n| 脚本 | 作用 | 关键输出 |\n|------|------|---------|\n| `scripts/pricing.py` | 定价与利润测算 | 单均净利、**保本售价**、**保本 ROI**、成本结构 |\n| `scripts/ad_calc.py` | 付费投放测算 | UV 价值、**可承受最高 CPC**、目标 ROI 反推 |\n| `scripts/diagnose.py` | 转化漏斗诊断 | 瓶颈环节定位、优先级处方、提升模拟 |\n| `scripts/product_score.py` | 选品六维评分 | 综合得分、短板识别与改进方向 |\n| `scripts/compliance.py` | 广告法合规检查 | 216 条违禁词库，三级风险分级与整改建议 |\n| `scripts/title_gen.py` | **商品标题生成** | 按平台字数上限批量产出候选，P0 违禁词自动剔除 |\n| `scripts/inventory.py` | **备货与资金占用测算** | 补货点 ROP、建议补货量、资金占用、断货/滞销风险 |\n| `scripts/live.py` | **实时数据桥接** | 拉取当前真实费率/进货价/搜索量，一键灌入上述计算器 |\n\n> `scripts/platform_fees.py` 是共享数据模块（八大平台佣金率、支付费率、\n> 行业转化基准），被 pricing / diagnose / product_score 共同引用，\n> 可用 `python scripts/platform_fees.py` 直接查看，数值均可用各脚本参数覆盖。\n\n### 让工具\"实时可用\"：live.py\n\n前面七个工具再准，也依赖**真实入参**。与其凭记忆填佣金率、退货率、进货价、\n搜索量，`live.py` 把\"先拉实时数据、再灌入计算器\"标准化：\n\n```bash\n# 看某平台该去哪拉实时数据（官方公示页 / 公开指数工具，无需 API key）\npython scripts/live.py sources --platform douyin\n\n# 看 live_data.json 该收集哪些字段、单位是什么\npython scripts/live.py schema\n\n# 把 WebSearch/WebFetch 拉到的实时值写入 live_data.json，生成执行命令\npython scripts/live.py plan --in live_data.json\n```\n\n`plan` 会按\"先 `pricing` 算毛利率 → 再 `product_score` / `ad_calc` 串联\"的顺序\n生成命令，并标注缺失字段；报告自动带上\"数据截至 YYYY-MM-DD\"水印。\n`live.py fetch fx` 还能本机直连实时汇率接口（跨境成本换算用），网络受限时\n优雅降级并提示改用 Agent 侧 WebFetch。\n\n详见 SKILL.md 的「实时数据路由」与工作流 E。\n\n### 亮点设计\n\n**1. 定价用 100 单基准法，而不是简单减法**\n\n退货产生的去程运费、包材、损耗都不可回收，这是\"卖爆了却在亏钱\"的\n根本原因。脚本模拟发出 100 单、其中 r% 退货，分别核算收入与成本，\n再折算回单均利润。\n\n```bash\npython scripts/pricing.py --cost 35 --price 129 --platform douyin \\\n    --shipping 4.5 --packaging 1.5 --return-rate 30 --ad-ratio 18\n```\n\n**2. 诊断看的是相对基准的偏离度，不是绝对值高低**\n\n哪个环节相对行业基准差得最多，哪个才是真瓶颈，修复它的投入产出比最高。\n\n```bash\npython scripts/diagnose.py --impression 200000 --click 2000 \\\n    --order 110 --paid 55 --gmv 6600\n```\n\n```\n  [!]  点击率         1.00%  基准 2.0~5.0%    偏低 偏离 50.0%\n  [OK] 下单率         5.50%  基准 3.0~8.0%    正常\n  [!]  支付率        50.00%  基准 60.0~85.0%  偏低 偏离 16.7%\n\n--- 瓶颈定位 ---\n  最大瓶颈: 曝光 -> 点击（点击率）\n  可能归因: 主图/短视频首帧、标题、价格带、人群"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7d4jg6kwefccgm7gdmxkzkv18c4neh\",\n  \"slug\": \"cn-ecommerce-ops\",\n  \"version\": \"1.2.1\",\n  \"publishedAt\": 1788753272126\n}"},{"path":"references/crossborder-temu.md","content":"# Temu 跨境运营手册（全托管 / 半托管 / 本对本）\n\n> 本手册基于 2026 年公开资料与卖家社群口径整理。Temu 规则迭代极快，\n> **所有费率、保证金、时效数字务必以 Temu 卖家中心（seller.kuajingmaihuo.com）\n> 规则中心与招商经理的最新口径为准**。多方来源数字冲突处本文已标注。\n\n## 一、三种模式对比\n\n| 维度 | 全托管 | 半托管 | 本对本 |\n|------|--------|--------|--------|\n| 本质 | 供货模式：你是平台供应商 | 卖家自履约 + 平台流量 | 海外本土店 |\n| 货物位置 | 发 Temu 国内集运仓 | 你的海外仓 / 3PL | 目标国本土仓 |\n| 定价权 | 无（平台核价定价） | 有（系统给参考价，可申诉） | 基本自主 |\n| 保证金 | 约 ¥1,000（可退） | 约 ¥10,000 或 $1,400 | 依站点政策 |\n| 佣金 | 名义 0（差价隐含 2%~5%） | 按类目约 6%~15%（口径不一） | 依站点政策 |\n| 回款周期 | 慢（约 30 天上下） | 快（确认收货 T+1，约 8 天） | 依站点 |\n| 履约时效 | 平台负责 | 严考核（48h 上网率等） | 2~5 天签收 |\n| 适合 | 源头工厂、清库存、测款 | 有海外仓/物流资源的卖家 | 有海外主体的品牌卖家 |\n\n**选型铁律**：无跨境经验先全托管测款，但不要把全托管当长期利润来源——\n定价权为零意味着利润天花板由平台决定。有海外仓能力尽早转半托管。\n\n## 二、核价逻辑（全托管的生死线）\n\n- 全托管报价 = 你愿意接受的最低单件回款。平台核价普遍对标 1688 同款价\n  与全网低价，报价虚高直接被拒或限流。\n- 2026 年《互联网平台价格行为规则》生效后，平台已取消\"强制跟价\"，\n  价格在流量分配中的权重下降，评分/履约/合规权重上升——但低价竞争力\n  仍是入池前提。\n- 报价测算路径：先用 `scripts/pricing.py` 按\"供货价=售价\"反推你的保本\n  供货价（成本+头程分摊+损耗），报价低于此值就是亏本供货。\n- 半托管定价：系统核价有异议可在后台提交成本凭证申诉（公开口径称\n  2 个工作日内处理，以实际为准）。\n\n## 三、合规红线（2026 严查项）\n\n无以下文件，欧美站点直接下架+罚款：\n\n1. **欧代 / 英代 / 美代**：欧盟、英国、美国站点的授权代表（公开行情约\n   ¥500~2000/年，服务商报价差异大）。\n2. **EPR 注册**：包装法、电池法、WEEE 等，按类目与站点（约 ¥300~1500/类目）。\n3. **产品认证**：CE（欧盟）、FCC（美国电子类）、CPC/CPSIA（母婴儿童）、\n   FDA（食品接触/美妆按类目）。\n4. **知识产权**：标题/图片含品牌词、卡通形象、专利外观 = 下架 + 扣罚，\n   严重封店。无品牌散件也要排查外观专利。\n\n汽车配件类（如 LED 车灯）特别注意：涉及车辆安全件的类目在部分站点\n有额外认证要求（如 DOT/E-mark），上架前必须在卖家中心核对类目资质清单。\n\n## 四、履约与罚则（卖家社群口径，以后台罚则页为准）\n\n- 订单履约率要求 ≥95%，入仓质检通过率 ≥90%（社群口径）；断货一次\n  可能导致链接权重清零。\n- 延迟发货、缺货、质检不合格均有梯度罚款；质量事故罚款可达数万元级\n  （社群有个案报道），务必留足质检余量。\n- 半托管 48 小时上网率等时效考核趋严，选择海外仓/尾程服务商时优先\n  看轨迹上网速度而非单纯价格。\n\n## 五、与本技能工具的串联\n\n1. **测款**：`scripts/product_score.py` 评估品类（Temu 偏好轻小件、标品、\n   低客单；重货大件基本被劝退）。\n2. **报价**：`scripts/pricing.py --platform temu`，把供货价当售价算保本线；\n   半托管把海外仓+尾程成本计入 `--shipping` 与 `--other`。\n3. **备货**：海外仓备货用 `scripts/inventory.py` 测算——头程海运 30 天+\n   的供货周期下，安全天数建议 15 天以上（`--safety-days 15`）。\n4. **标题**：英文标题 ≤80 字符（公开口径），用 `scripts/title_gen.py\n   --limit 80` 生成候选后人工本地化。\n5. **实时数据**：`scripts/live.py sources --platform temu` 获取核验入口。\n\n## 六、常见坑速查\n\n- 全托管爆款可能被平台要求转半托管（\"同款绑定\"社群口径），提前评估\n  海外仓能力。\n- 回款周期长，现金流按 45 天以上规划（全托管）。\n- 单日上新有上限（公开口径 400 条/日，与店铺动销挂钩），精铺优于铺货。\n- 保证金从回款中冻结而非预缴（2026 年口径），关店无违规可退。\n\n> 免责声明：以上为公开信息整理，不构成平台官方规则解释；\n> 违规认定与罚则以 Temu 卖家中心公示及协议为准。"},{"path":"references/listing-and-content.md","content":"# 商品呈现与内容创作手册\n\n> 流量进来之后，能否转化全靠这一环。所有对外文案发布前，\n> 必须先经过 `scripts/compliance.py` 合规扫描。\n\n---\n\n## 一、标题优化\n\n### 各平台字数限制\n| 平台 | 上限 | 备注 |\n|------|------|------|\n| 淘宝 / 天猫 | 30 汉字（60 字符） | 用满，不浪费字符 |\n| 京东 | 30 汉字左右 | 品牌词前置 |\n| 拼多多 | 60 字符 | 简洁直白，突出价格力 |\n| 抖音商城 | 30 汉字左右 | 口语化，贴近搜索习惯 |\n| 小红书笔记 | 20 汉字（显示约 20 字） | 前 10 字最关键 |\n\n### 标题结构公式\n```\n营销词 + 品牌词 + 核心词 + 属性词 + 场景词 + 长尾词\n```\n\n**示例**（女士针织衫）：\n```\n2024新款 XX品牌 针织开衫 女 宽松 慵懒风 春秋 外搭 小个子 上衣\n```\n\n### 关键原则\n1. **核心词必须完整可切分** —— 不要把\"针织开衫\"拆成\"针织 时尚 开衫\"，\n   否则搜索引擎无法完整匹配\"针织开衫\"这个词。\n2. **新品用长尾词，成熟品抢大词** —— 新品没有权重，抢大词只会被淹没。\n   先用\"针织开衫女小个子慵懒风\"这类精准长尾词吃转化。\n3. **属性词必须与后台属性一致** —— 不一致会被判定为标题违规或降权。\n4. **不堆砌无关热词** —— 引来不精准流量会打乱人群标签，得不偿失。\n5. **禁用广告法违禁词** —— \"最\"字系、\"第一\"、\"国家级\"等一律不能出现。\n\n### 关键词来源\n- 平台搜索下拉框（真实用户搜索）\n- 竞品标题拆解（取交集高频词）\n- 生意参谋 / 抖音电商罗盘 / 京东商智的搜索词分析\n- 直通车关键词报表（有真实点击数据的词最可靠）\n\n---\n\n## 二、主图设计（决定点击率）\n\n### 五图 + 一视频的标准配置\n| 位置 | 作用 | 要点 |\n|------|------|------|\n| 主图 1 | 抓眼球 | 产品主体清晰 + 一句核心卖点（≤8字） |\n| 主图 2 | 卖点强化 | 最强差异化功能，用对比或数据体现 |\n| 主图 3 | 场景化 | 产品在真实使用场景中的样子 |\n| 主图 4 | 细节特写 | 材质、工艺、做工，建立品质感 |\n| 主图 5 | 信任状 | 资质证书、检测报告、售后承诺 |\n| 主图视频 | 综合展示 | 15–30 秒，前 3 秒必须有信息量 |\n\n### 提升点击率的实操要点\n- **左上角是黄金视觉区**，最重要的信息放这里（符合 F 型视觉动线）\n- 文字**不超过图片面积 20%**（平台规则），且必须大而清晰，\n  手机上缩略图只有指甲盖大小，小字等于没有\n- **色彩要跳出搜索结果页**：竞品都用白底，你用彩底就能跳出来\n- **主图必须 A/B 测试**，用直通车小预算测点击率，\n  跑出高于行业均值的图再放大投放，不要凭审美决定\n\n---\n\n## 三、详情页黄金结构\n\n用户决策路径：**我有什么问题 → 你能解决吗 → 凭什么信你 → 为什么现在买**\n\n| 屏序 | 内容 | 目的 |\n|------|------|------|\n| 第 1 屏 | 核心卖点 + 使用场景大图 | 3 秒内说清\"这是什么、解决什么\" |\n| 第 2 屏 | 痛点场景还原 | 引发共鸣：\"这说的就是我\" |\n| 第 3 屏 | 解决方案 + 核心功能 | 给出答案 |\n| 第 4 屏 | 参数与规格 | 满足理性决策需求 |\n| 第 5 屏 | 细节展示 | 材质、做工、工艺 |\n| 第 6 屏 | 信任背书 | 资质、检测报告、销量、媒体报道 |\n| 第 7 屏 | 用户评价 / 买家秀 | 从众心理，真实感最重要 |\n| 第 8 屏 | 售后保障 | 消除最后顾虑（七天无理由、运费险、质保） |\n| 第 9 屏 | 促销信息 + 行动号召 | 临门一脚，制造合理紧迫感 |\n\n**核心原则**：\n- **前三屏决定 70% 的跳失**，最强的内容必须前置\n- 移动端优先，单张图高度不超过 1200px，避免加载过慢\n- **不要用大段文字**，用图 + 短句，用户是\"扫\"不是\"读\"\n- 促销紧迫感必须**真实**（虚构倒计时构成价格欺诈）\n\n---\n\n## 四、短视频带货脚本框架\n\n### 黄金 3 秒开场（决定生死）\n四种经过验证的开场方式：\n1. **痛点直击** —— \"你是不是也这样...\"\n2. **结果前置** —— 直接展示使用后的效果\n3. **反常识冲突** —— \"千万别再这样做了\"\n4. **身份代入** —— \"小个子女生一定要看\"\n\n### 30–60 秒脚本结构\n```\n0–3s   黄金开场（痛点/结果/冲突）\n3–10s  问题放大（为什么这件事很麻烦）\n10–25s 产品出场 + 核心卖点演示（要看得见的效果）\n25–40s 使用场景 + 效果展示\n40–50s 信任背书（销量/资质/真实反馈）\n50–60s 行动号召 + 利益点（限时优惠、赠品）\n```\n\n### 关键指标与优化方向\n| 指标不达标 | 优化位置 |\n|-----------|---------|\n| 3 秒完播率低 | 开场没抓住人，重做前 3 秒 |\n| 完播率低 | 中段节奏拖沓，删冗余镜头 |\n| 点击率低 | 挂车时机不对，或产品与内容不匹配 |\n| 转化率低 | 落地页承接问题，看详情页与价格 |\n\n---\n\n## 五、直播运营\n\n### 单场直播节奏（15–25 分钟一个循环）\n```\n1. 引流憋单（3–5 分钟）\n   用福利款/秒杀留人，拉停留时长，积累在线人数\n2. 产品讲解（8–12 分钟）\n   痛点 → 卖点 → 演示 → 对比 → 信任状\n3. 逼单成交（3–5 分钟）\n   限时限量、价格锚点、赠品叠加，倒数上链接\n4. 循环往复\n```\n\n### 货盘结构\n- **福利款** —— 引流留人，亏本或平本，控制数量\n- **爆款/主推款** —— 走量核心，占销售额 50% 以上\n- **利润款** —— 赚钱主力\n- **形象款** —— 拉高客单价与直播间调性\n\n### 核心指标诊断\n| 指标 | 说明 | 偏低时的动作 |\n|------|------|------------|\n| 平均停留时长 | 低于 30 秒说明开场有问题 | 改开场话术、加福利钩子 |\n| UV 价值 | 成交额 ÷ 观看人数 | 提高转化或客单价 |\n| 转化率 | 成交人数 ÷ 观看人数 | 优化讲解与逼单话术 |\n| 互动率 | 评论点赞 ÷ 观看 | 增加互动引导与抽奖 |\n\n---\n\n## 六、评价与口碑运营\n\n评价是转化率的**决定性因素之一**，尤其是前 10 条。\n\n### 实操要点\n- **首批评价至关重要**，必须确保真实优质，带图带视频\n- 主动引导评价：包裹卡（不得以好评返现诱导，平台明令禁止）、\n  售后回访、会员积分\n- **差评必须第"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"国内电商全链路运营专家技能，覆盖淘宝、天猫、京东、拼多多、抖音电商、小红书、视频号、Temu八大平台。提供选品评分、定价与利润测算（含达人佣金）、广告投放ROI测算、店铺转化漏斗诊断、广告法违禁词合规检查、商品标题生成、备货与资金占用测算七个可计算工具，以及一个实时数据桥接器(live.py)——先用 WebSearch/WebFetch 拉取当前真实佣金率、类目退货率、1688进货价、关键词搜索量，再一键灌入各计算器，实现\"实时可用\"的决策。当用户涉及国内电商选品、定价、算利润、算ROI、投直通车或千川、做店铺诊断、写商品标题、算备货量、优化标题主图详情页、写商品文案、直播运营、检查文案是否违反广告法、Temu全托管半托管报价与合规、平台规则与流量玩法，或需要查最新费率/获取实时行情来辅助决策时，应使用本技能。 Skill: 国内电商全链路运营 Owner: g305595965 Summary: 国内电商全链路运营专家技能，覆盖淘宝、天猫、京东、拼多多、抖音电商、小红书、视频号、Temu八大平台。提供选品评分、定价与利润测算（含达人佣金）、广告投放ROI测算、店铺转化漏斗诊断、广告法违禁词合规检查、商品标题生成、备货与资金占用测算七个可计算工具，以及一个实时数据桥接器(live.py)——先用 WebSearch/WebFetch 拉取当前真实佣金率、类目退货率、1688进货价、关键词搜索量，再一键灌入各计算器，实现\"实时可用\"的决策。当用户涉及国内电商选品、定价、算利润、算ROI、投直通车或千川、做店铺诊断、写商品标题、算备货量、优化标题主图详情页、写商品文案、直播运营、检查文案是否违反广告法、Temu全托管半托管报价与合规、平台规则与流量玩法，或需要查最新费率/获取实时行情来辅助决策时，应使用本技能。 Tags: ROI:1.0.","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":577,"uniquenessScore":58,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T21:19:54.239Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T21:19:54.239Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-12T12:11:27.927Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}