{
  "markdown": "# 跨境电商竞品分析Skill\n\n<div align=\"center\">\n\n<img src=\"assets/banner.png\" alt=\"跨境电商竞品分析\" width=\"100%\">\n\n**把\"对手到底强在哪\"变成一份可执行的竞品分析报告**\n\n**Created By Buluslan**\n\n**想了解更多最新AI行业动态，AI+电商/广告的行业实践方法，人与AI如何协作共生的思考，请关注公众号：【新西楼】**\n\n![qrcode_for_gh_e3b954bd3859_258](https://github.com/user-attachments/assets/d8f068d9-c4f8-46c7-914c-fbcab5d52f2a)\n\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Claude Code](https://img.shields.io/badge/Claude_Code-Skill-blue)](https://claude.ai/code)\n[![Version](https://img.shields.io/badge/version-1.0.1-black.svg)]()\n\n</div>\n\n## 概述\n\necommerce-competitor-analyzer 是由 buluslan（公众号：新西楼.AI）研发的电商竞品分析 Skill，他会帮你拆解竞对的定价、评论、流量结构和差异化空间，把\"对手到底强在哪\"变成一份可执行的竞品分析报告。\n\n> [!TIP]\n> **更多跨境电商 AI 实战内容，请关注公众号「新西楼.AI」**\n\n这是一个 [Claude Code Skill](https://claude.ai/code)，可以自动分析多个电商平台（Amazon、Temu、Shopee等）的竞品数据，并生成全面的 AI 分析报告。\n\n### 核心功能\n\n- **多平台支持**：Amazon（已启用）、Temu 和 Shopee（计划中）\n- **批量处理**：单次请求分析多个产品\n- **AI 驱动分析**：四维度分析框架：\n  - 文案策略与关键词分析\n  - 视觉资产设计方法论\n  - 客户评论情感分析\n  - 市场定位与竞争情报\n- **双格式输出**：\n  - Google Sheets（结构化数据）\n  - Markdown 报告（详细分析）\n- **错误隔离**：单个产品失败不会中断批量处理\n\n## 什么是 Claude Code Skill？\n\n**技能**是 Claude Code AI 的\"使用手册\"。它通过提供结构化的提示词、脚本和配置，让 Claude 能够执行专业任务。\n\n使用本技能，你只需要说：\n> \"分析这些 Amazon 产品：B0C4YT8S6H, B08N5WRQ1Y, B0CLFH7CCV\"\n\nClaude 就会：\n1. 从 Amazon 提取产品数据\n2. 生成 AI 驱动的分析报告，主要包括：\n- 基础信息：商品标题、价格、评分情况等。\n- 内容分析：listing文案的方法论总结，高频卖点和内容亮点，TOP10高频关键词分析。\n- 视觉分析：主图和A+的设计方法论总结，视觉动线拆解。\n- 评论分析：统计评论数量和星级分布，并详细分析最新的评论内容，分别总结3条产品优势和缺陷，输出改进建议。\n- 其他分析：包括asin排名和市场动态，Q&A中的高频问题分析，以及整体的分析总结。\n4. 将结果输出到 Google Sheets 和 Markdown 文件\n\n## 系统要求\n\n### 必需的 API 密钥\n\n| 服务 | 用途 | 费用 |\n|---------|---------|------|\n| **Olostep API** | 网页数据抓取 | 1000 次免费请求/月，之后 $0.002/次 |\n| **Google Gemini API** | AI 分析 | ~$0.001/产品 |\n\n### 可选的 API 密钥\n\n| 服务 | 用途 |\n|---------|---------|\n| **Google Sheets API** | 将结果导出到 Google Sheets |\n\n## 安装\n\n### 步骤 1：安装技能\n\n```bash\n# 使用 npx skills（推荐）\nnpx skills add buluslan/ecommerce-competitor-analyzer\n\n# 或手动克隆\ngit clone https://github.com/buluslan/ecommerce-competitor-analyzer.git\ncp -r ecommerce-competitor-analyzer ~/.claude/skills/main-mode-skills/ecommerce-competitor-analyzer.skill\n```\n\n### 步骤 2：配置环境变量\n\n```bash\n# 复制示例环境文件\ncd ~/.claude/skills/main-mode-skills/ecommerce-competitor-analyzer.skill\ncp .env.example .env\n\n# 编辑 .env 并添加你的 API 密钥\nnano .env\n```\n\n添加你的 API 密钥：\n```bash\nOLOSTEP_API_KEY=your_olostep_api_key_here\nGEMINI_API_KEY=your_gemini_api_key_here\nGOOGLE_SHEETS_ID=your_google_sheets_id_here\n```\n\n### 步骤 3：验证安装\n\n```bash\n# 列出已安装的技能\n~/.claude/list-skills.sh\n```\n\n## 使用方法\n\n### 基础用法（单个产品）\n\n在 Claude Code 中，只需说：\n\n```\n分析这个 Amazon 产品：B0C4YT8S6H\n```\n\nClaude 会：\n1. 从 Amazon 提取产品数据\n2. 生成全面的分析报告\n3. 保存到 Google Sheets（1行）+ Markdown 文件\n\n### 批量分析（多个产品）\n\n```\n分析这些 Amazon 产品：\nB0C4YT8S6H\nB08N5WRQ1Y\nB0CLFH7CCV\n```\n\n或使用 URL：\n\n```\n分析这些产品：\nhttps://amazon.com/dp/B0C4YT8S6H\nhttps://amazon.com/dp/B08N5WRQ1Y\n```\n\n### 输出格式\n\n#### 格式 1：Google Sheets（结构化数据）\n\n| ASIN | 产品标题 | 价格 | 评分 | 文案分析 | 视觉分析 | 评论分析 | 市场分析 |\n|------|--------------|-------|--------|---------------------|-----------------|-----------------|-----------------|\n| B0C4YT8S6H | Samsung Galaxy Tab A9+ | $159.99 | 4.4 | [300字摘要] | [300字摘要] | [300字摘要] | [300字摘要] |\n\n#### 格式 2：Markdown 报告（详细分析）\n\n```markdown\n# Amazon 竞品分析报告\n\n## 产品 1：B0C4YT8S6H\n\n### 基本信息\n- 标题：Samsung Galaxy Tab A9+ Plus 11\" 64GB Android Tablet\n- 价格：$159.99\n- 评分：4.4/5\n\n### 文案策略与关键词分析\n[完整分析内容...]\n\n### 视觉资产设计方法论\n[完整分析内容...]\n\n### 客户评论分析\n[完整分析内容...]\n\n### 市场定位与竞争情报\n[完整分析内容...]\n```\n\n## 配置\n\n### Google Sheets 设置（可选）\n\n如果要将结果导出到 Google Sheets：\n\n1. **创建 Google Cloud 项目**\n   - 访问 [Google Cloud Console](https://console.cloud.google.com/)\n   - 创建新项目\n\n2. **启用 Google Sheets API**\n   - 导航到\"API 和服务\" > \"库\"\n   - 搜索\"Google Sheets API\"\n   - 点击\"启用\"\n\n3. **创建 OAuth2 凭证**\n   - 导航到\"API 和服务\" > \"凭据\"\n   - 点击\"创建凭据\" > \"OAuth 客户端 ID\"\n   - 应用类型：\"桌面应用\"\n   - 下载 JSON 凭证文件\n\n4. **配置技能**\n   - 复制 JSON 文件内容\n   - 粘贴到 `.env` 中的 `GOOGLE_SHEETS_CREDENTIALS`\n   - 添加你的 Google Sheets ID 作为 `GOOGLE_SHEETS_ID`\n\n### 高级设置\n\n编辑 `platforms.yaml` 进行高级配置：\n\n```yaml\nsettings:\n  max_batch_size: 20        # 每批最大产品数\n  concurrency_limit: 5      # 并发处理数\n  scraping_timeout: 120000  # 2分钟\n  analysis_timeout: 60000   # 1分钟\n```\n\n## 项目结构\n\n```\necommerce-competitor-analyzer.skill/\n├── SKILL.md                                # AI 指令手册\n├── platforms.yaml                          # 平台配置\n├── .env.example                            # 配置模板\n├── scripts/                                # 核心脚本\n│   ├── detect-platform.js                 # 平台检测\n│   ├── scrape-amazon.js                   # Amazon 爬虫\n│   └── batch-processor.js                 # 批处理引擎\n├── prompts/                                # AI 提示词模板\n│   ├── analysis-prompt-base.md            # 基础分析框架\n│   ├── analysis-prompt-amazon.md          # Amazon 专用提示词\n│   └── analysis-prompt-cross-platform.md  # 跨平台对比\n└── references/                             # 文档\n    ├── n8n-workflow-analysis.md           # n8n 工作流参考\n    └── platform-differences.md            # 平台对比\n```\n\n## API 密钥获取指南\n\n### 1. Olostep API\n\n1. 访问 [https://olostep.com/](https://olostep.com/)\n2. 注册免费账户\n3. 导航到 Dashboard > API Keys\n4. 复制你的 API 密钥\n5. 添加到 `.env`：`OLOSTEP_API_KEY=your_key_here`\n\n**费用**：1000 次免费请求/月，之后 $0.002/次\n\n### 2. Google Gemini API\n\n1. 访问 [https://aistudio.google.com/app/apikey](https://aistudio.google.com/app/apikey)\n2. 点击\"创建 API 密钥\"\n3. 复制密钥\n4. 添加到 `.env`：`GEMINI_API_KEY=your_key_here`\n\n**费用**：~$0.001/产品分析\n\n### 3. Google Sheets API（可选）\n\n参见上面的\"Google Sheets 设置\"部分。\n\n## 故障排除\n\n### 问题：\"Olostep API key not found\"\n\n**解决方案**：确保你已从 `.env.example` 创建了 `.env` 文件并添加了你的 API 密钥。\n\n### 问题：\"Google Sheets authentication failed\"\n\n**解决方案**：确保 `.env` 中的 `GOOGLE_SHEETS_CREDENTIALS` 包含有效的 JSON（单行）。\n\n### 问题：\"Batch processing timeout\"\n\n**解决方案**：增加 `.env` 中的 `SCRAPER_TIMEOUT` 或减少批量大小。\n\n### 问题：\"部分产品失败但其他成功\"\n\n**解决方案**：这是预期行为。技能使用错误隔离机制 - 单个失败不会中断整批处理。检查输出报告中的失败项。\n\n## 开发\n\n### 运行测试\n\n```bash\n# 测试平台检测\nnode scripts/detect-platform.js https://amazon.com/dp/B0C4YT8S6H\n\n# 测试爬虫\nnode scripts/scrape-amazon.js B0C4YT8S6H\n```\n\n### 添加新平台\n\n1. 在 `platforms.yaml` 中添加平台配置\n2. 在 `scripts/` 中创建爬虫脚本\n3. 在 `prompts/` 中创建分析提示词\n4. 更新 `scripts/detect-platform.js`\n\n## 贡献\n\n欢迎贡献！请：\n\n1. Fork 仓库\n2. 创建功能分支\n3. 进行更改\n4. 提交 Pull Request\n\n### 贡献方向\n\n- [ ] 添加 Temu 平台支持\n- [ ] 添加 Shopee 平台支持\n- [ ] 改进错误处理\n- [ ] 添加更多 AI 分析维度\n- [ ] 创建 Excel 导出格式\n- [ ] 添加 PDF 报告生成\n\n## 许可证\n\n本项目基于 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件。\n\n## 致谢\n\n- 基于 n8n 工作流 v81 逻辑构建\n- 使用 Olostep API 进行网页抓取\n- 使用 Google Gemini API 进行 AI 分析\n- 宝玉的 Skills 框架\n\n## 支持\n\n- **问题反馈**：[GitHub Issues](https://github.com/buluslan/ecommerce-competitor-analyzer/issues)\n- **讨论交流**：[GitHub Discussions](https://github.com/buluslan/ecommerce-competitor-analyzer/discussions)\n- **联系Builder，请备注【github】**：\n\n<img width=\"717\" height=\"714\" alt=\"wechat_2025-10-17_173400_583\" src=\"https://github.com/user-attachments/assets/7c406098-dcd9-4684-84bd-f0ed4213e95f\" />\n\n\n## 路线图\n\n- [x] Amazon 平台支持\n- [ ] Temu 平台支持\n- [ ] Shopee 平台支持\n- [ ] 跨平台对比\n- [ ] 历史价格追踪\n- [ ] 评论情感可视化\n- [ ] 竞品价格提醒\n- [ ] 自动每日分析\n\n---\n\n<div align=\"center\">\n\n**专为跨境电商从业者打造 ❤️**\n\n[⬆ 返回顶部](#跨境电商竞品分析Skill)\n\n</div>\n",
  "bytes": 7026,
  "sha": "e569fd15aa1a53bb94190209732b80f7cc2a3458fba63b902f26e869a38aa81f",
  "repo_slug": "buluslan/ecommerce-competitor-analyzer",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_buluslan_ecommerce_competitor_analyzer_e_1a27e6ba/readme"
}