ai-marketing-claude-suite

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

AI Marketing Suite for Claude Code

面向Claude Code的AI营销套件

Skill by ara.so — Marketing Skills collection.

This skill enables Claude Code to perform comprehensive marketing analysis, copywriting, competitive intelligence, and automation tasks. It includes 15 specialized marketing skills with parallel subagent execution, automated website analysis, and client-ready PDF report generation.

由ara.so开发的Skill——营销技能合集。

该Skill使Claude Code能够执行全面的营销分析、文案撰写、竞品情报收集和自动化任务。它包含15项专业营销技能，支持并行子Agent执行、自动化网站分析以及可交付给客户的PDF报告生成。

What This Project Does

项目功能

AI Marketing Claude is a comprehensive marketing automation suite that:

Audits websites across 6 marketing dimensions (content, conversion, SEO, competitive, brand, growth)
Generates marketing copy with before/after optimization examples
Creates email sequences (welcome, nurture, launch) with full automation
Builds content calendars for 30-day social media planning
Analyzes competitors with automated intelligence gathering
Produces PDF reports suitable for client deliverables
Scores marketing effectiveness with weighted methodology (0-100)

All functionality is accessible through

/market

commands in Claude Code.

AI Marketing Claude是一套全面的营销自动化套件，可实现：

网站审计：从6个营销维度（内容、转化、SEO、竞品、品牌、增长）进行审计
营销文案生成：提供优化前后的示例
邮件序列创建（欢迎、培育、发布）：支持全自动化
内容日历构建：用于30天社交媒体规划
竞品分析：自动化情报收集
PDF报告生成：适用于客户交付物
营销效果评分：采用加权评分法（0-100分）

所有功能均可通过Claude Code中的

/market

命令访问。

Installation

安装方法

One-Command Install

一键安装

bash

curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/ai-marketing-claude/main/install.sh | bash

bash

curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/ai-marketing-claude/main/install.sh | bash

Manual Installation

手动安装

bash

git clone https://github.com/zubair-trabzada/ai-marketing-claude.git
cd ai-marketing-claude
./install.sh

The installer copies skill files to

~/.claude/skills/

and agent definitions to

~/.claude/agents/

bash

git clone https://github.com/zubair-trabzada/ai-marketing-claude.git
cd ai-marketing-claude
./install.sh

安装程序会将Skill文件复制到

~/.claude/skills/

，并将Agent定义复制到

~/.claude/agents/

。

Optional PDF Support

可选PDF支持

For client-ready PDF reports:

bash

pip install reportlab

如需生成可交付给客户的PDF报告：

bash

pip install reportlab

Python Dependencies

Python依赖

bash

pip install -r requirements.txt

Required packages:

```
requests
```
- HTTP requests for webpage analysis
```
beautifulsoup4
```
- HTML parsing and content extraction
```
reportlab
```
- PDF generation (optional)

bash

pip install -r requirements.txt

所需依赖包：

```
requests
```
：用于网页分析的HTTP请求
```
beautifulsoup4
```
：HTML解析与内容提取
```
reportlab
```
：PDF生成（可选）

Core Commands

核心命令

Command	Purpose	Output
`/market audit <url>`	Full marketing audit with 5 parallel agents	Scored report (69/100 format)
`/market quick <url>`	60-second marketing snapshot	Quick analysis
`/market copy <url>`	Generate optimized copy	Before/after examples
`/market emails <topic>`	Email sequence generator	5-8 email sequence
`/market social <topic>`	Social media calendar	30-day content plan
`/market ads <url>`	Ad creative and copy	Multi-platform ads
`/market funnel <url>`	Sales funnel analysis	Funnel optimization
`/market competitors <url>`	Competitive intelligence	Competitor report
`/market landing <url>`	Landing page CRO	CRO recommendations
`/market launch <product>`	Product launch playbook	Launch checklist
`/market proposal <client>`	Client proposal generator	Proposal document
`/market report <url>`	Marketing report (Markdown)	.md file
`/market report-pdf <url>`	Professional PDF report	.pdf file
`/market seo <url>`	SEO content audit	SEO analysis
`/market brand <url>`	Brand voice analysis	Brand guidelines

命令	用途	输出
`/market audit <url>`	5个并行Agent执行的完整营销审计	评分报告（如69/100格式）
`/market quick <url>`	60秒营销快照分析	快速分析结果
`/market copy <url>`	生成优化文案	优化前后示例
`/market emails <topic>`	邮件序列生成器	5-8封邮件的序列
`/market social <topic>`	社交媒体日历	30天内容规划
`/market ads <url>`	广告创意与文案	多平台广告内容
`/market funnel <url>`	销售漏斗分析	漏斗优化建议
`/market competitors <url>`	竞品情报收集	竞品报告
`/market landing <url>`	着陆页CRO（转化率优化）	CRO建议
`/market launch <product>`	产品发布手册	发布清单
`/market proposal <client>`	客户提案生成器	提案文档
`/market report <url>`	营销报告（Markdown格式）	.md文件
`/market report-pdf <url>`	专业PDF报告	.pdf文件
`/market seo <url>`	SEO内容审计	SEO分析结果
`/market brand <url>`	品牌调性分析	品牌指南

Usage Patterns

使用模式

Running a Full Marketing Audit

运行完整营销审计

bash

/market audit https://example.com

This command:

Launches 5 parallel subagents (content, conversion, SEO, competitive, strategy)
Scores the website across 6 dimensions
Generates actionable recommendations
Saves output to
```
MARKETING-AUDIT.md
```

Expected output format:

Launching 5 parallel agents...
✓ Content & Messaging Analysis     — Score: 72/100
✓ Conversion Optimization          — Score: 58/100
✓ SEO & Discoverability            — Score: 81/100
✓ Competitive Positioning          — Score: 64/100
✓ Brand & Trust                    — Score: 76/100
✓ Growth & Strategy                — Score: 61/100

Overall Marketing Score: 69/100

Full report saved to MARKETING-AUDIT.md

bash

/market audit https://example.com

该命令：

启动5个并行子Agent（内容、转化、SEO、竞品、策略）
从6个维度为网站评分
生成可执行的建议
将输出保存到
```
MARKETING-AUDIT.md
```

预期输出格式：

Launching 5 parallel agents...
✓ Content & Messaging Analysis     — Score: 72/100
✓ Conversion Optimization          — Score: 58/100
✓ SEO & Discoverability            — Score: 81/100
✓ Competitive Positioning          — Score: 64/100
✓ Brand & Trust                    — Score: 76/100
✓ Growth & Strategy                — Score: 61/100

Overall Marketing Score: 69/100

Full report saved to MARKETING-AUDIT.md

Generating Email Sequences

生成邮件序列

bash

/market emails SaaS product launch

Produces a complete email sequence with:

Subject lines and preview text
Email bodies with personalization
CTAs and timing recommendations
A/B test variations

bash

/market emails SaaS product launch

生成完整的邮件序列，包含：

主题行与预览文本
带个性化内容的邮件正文
CTA（号召性用语）与时间建议
A/B测试变体

Creating Social Media Calendars

创建社交媒体日历

bash

/market social AI productivity tools

Generates 30-day content calendar with:

Daily post ideas
Platform-specific formatting
Hashtag recommendations
Engagement strategies

bash

/market social AI productivity tools

生成30天内容日历，包含：

每日发帖创意
平台专属格式
话题标签建议
互动策略

Competitor Analysis

竞品分析

bash

/market competitors https://example.com

Automated competitive intelligence:

Identifies top competitors
Analyzes positioning and messaging
Extracts pricing strategies
Maps feature comparisons

bash

/market competitors https://example.com

自动化竞品情报收集：

识别顶级竞品
分析定位与messaging
提取定价策略
对比功能矩阵

Generating Client Proposals

生成客户提案

bash

/market proposal "Tech startup needing SEO services"

Creates customized proposal with:

Executive summary
Recommended services
Pricing tiers
Timeline and deliverables

bash

/market proposal "Tech startup needing SEO services"

生成定制化提案，包含：

执行摘要
推荐服务
定价层级
时间线与交付物

Python Script Integration

Python脚本集成

The suite includes Python scripts for automated analysis:

该套件包含用于自动化分析的Python脚本：

Website Analysis Script

网站分析脚本

python

undefined

python

undefined

scripts/analyze_page.py

import requests from bs4 import BeautifulSoup import json

def analyze_marketing(url): """ Analyzes a webpage for marketing effectiveness Returns structured data for scoring """ response = requests.get(url, headers={ 'User-Agent': 'Mozilla/5.0 (Marketing Analysis Bot)' }) soup = BeautifulSoup(response.content, 'html.parser')

analysis = {
    'headlines': extract_headlines(soup),
    'ctas': extract_ctas(soup),
    'value_props': extract_value_propositions(soup),
    'social_proof': extract_social_proof(soup),
    'seo_elements': extract_seo_elements(soup)
}

return analysis


Usage from Claude Code:
```bash
python scripts/analyze_page.py https://example.com

import requests from bs4 import BeautifulSoup import json

analysis = {
    'headlines': extract_headlines(soup),
    'ctas': extract_ctas(soup),
    'value_props': extract_value_propositions(soup),
    'social_proof': extract_social_proof(soup),
    'seo_elements': extract_seo_elements(soup)
}

return analysis


在Claude Code中使用：
```bash
python scripts/analyze_page.py https://example.com

Competitor Scanner

竞品扫描器

python

undefined

python

undefined

scripts/competitor_scanner.py

def scan_competitors(base_url): """ Identifies and analyzes competitor websites """ competitors = discover_competitors(base_url)

reports = []
for competitor in competitors:
    reports.append({
        'url': competitor,
        'positioning': analyze_positioning(competitor),
        'pricing': extract_pricing(competitor),
        'features': extract_features(competitor)
    })

return reports

undefined

def scan_competitors(base_url): """ Identifies and analyzes competitor websites """ competitors = discover_competitors(base_url)

reports = []
for competitor in competitors:
    reports.append({
        'url': competitor,
        'positioning': analyze_positioning(competitor),
        'pricing': extract_pricing(competitor),
        'features': extract_features(competitor)
    })

return reports

undefined

Social Calendar Generator

社交媒体日历生成器

python

undefined

python

undefined

scripts/social_calendar.py

def generate_calendar(topic, days=30, platforms=['linkedin', 'twitter']): """ Generates social media content calendar """ calendar = []

for day in range(days):
    for platform in platforms:
        post = {
            'day': day + 1,
            'platform': platform,
            'content': generate_post_idea(topic, platform),
            'hashtags': suggest_hashtags(topic, platform),
            'best_time': get_optimal_posting_time(platform)
        }
        calendar.append(post)

return calendar

undefined

def generate_calendar(topic, days=30, platforms=['linkedin', 'twitter']): """ Generates social media content calendar """ calendar = []

for day in range(days):
    for platform in platforms:
        post = {
            'day': day + 1,
            'platform': platform,
            'content': generate_post_idea(topic, platform),
            'hashtags': suggest_hashtags(topic, platform),
            'best_time': get_optimal_posting_time(platform)
        }
        calendar.append(post)

return calendar

undefined

PDF Report Generator

PDF报告生成器

python

undefined

python

undefined

scripts/generate_pdf_report.py

from reportlab.lib.pagesizes import letter from reportlab.platypus import SimpleDocTemplate, Paragraph, Spacer from reportlab.lib.styles import getSampleStyleSheet

def generate_pdf(audit_data, output_path='marketing-report.pdf'): """ Generates professional PDF marketing report Requires: pip install reportlab """ doc = SimpleDocTemplate(output_path, pagesize=letter) story = [] styles = getSampleStyleSheet()

# Title
story.append(Paragraph(f"Marketing Audit: {audit_data['url']}", styles['Title']))
story.append(Spacer(1, 12))

# Overall score
story.append(Paragraph(f"Overall Score: {audit_data['overall_score']}/100", styles['Heading1']))

# Category scores
for category, score in audit_data['categories'].items():
    story.append(Paragraph(f"{category}: {score}/100", styles['Heading2']))
    story.append(Paragraph(audit_data['recommendations'][category], styles['BodyText']))
    story.append(Spacer(1, 12))

doc.build(story)
return output_path

undefined

from reportlab.lib.pagesizes import letter from reportlab.platypus import SimpleDocTemplate, Paragraph, Spacer from reportlab.lib.styles import getSampleStyleSheet

# Title
story.append(Paragraph(f"Marketing Audit: {audit_data['url']}", styles['Title']))
story.append(Spacer(1, 12))

# Overall score
story.append(Paragraph(f"Overall Score: {audit_data['overall_score']}/100", styles['Heading1']))

# Category scores
for category, score in audit_data['categories'].items():
    story.append(Paragraph(f"{category}: {score}/100", styles['Heading2']))
    story.append(Paragraph(audit_data['recommendations'][category], styles['BodyText']))
    story.append(Spacer(1, 12))

doc.build(story)
return output_path

undefined

Architecture Overview

架构概述

Skill Hierarchy

Skill层级

market/SKILL.md                     # Main orchestrator (routes all commands)
├── skills/market-audit/SKILL.md    # Full audit coordination
├── skills/market-copy/SKILL.md     # Copywriting generation
├── skills/market-emails/SKILL.md   # Email sequences
├── skills/market-social/SKILL.md   # Social calendars
└── [11 more specialized skills]

market/SKILL.md                     # 主编排器（路由所有命令）
├── skills/market-audit/SKILL.md    # 完整审计协调
├── skills/market-copy/SKILL.md     # 文案生成
├── skills/market-emails/SKILL.md   # 邮件序列
├── skills/market-social/SKILL.md   # 社交媒体日历
└── [11个更多专业Skill]

Parallel Subagents

并行子Agent

The audit command spawns 5 parallel agents:

market-content.md - Analyzes messaging, headlines, value propositions, CTAs
market-conversion.md - Reviews funnels, forms, friction points, urgency
market-competitive.md - Assesses positioning, differentiation, market awareness
market-technical.md - Evaluates SEO, tracking, technical performance
market-strategy.md - Examines brand, pricing, growth channels

Each agent returns a structured score and recommendations.

审计命令会启动5个并行Agent：

market-content.md - 分析messaging、标题、价值主张、CTA
market-conversion.md - 审查漏斗、表单、摩擦点、紧迫感
market-competitive.md - 评估定位、差异化、市场认知度
market-technical.md - 评估SEO、追踪、技术性能
market-strategy.md - 审视品牌、定价、增长渠道

每个Agent都会返回结构化评分和建议。

Scoring Methodology

评分方法

Marketing effectiveness is scored across 6 weighted dimensions:

Category	Weight	Criteria
Content & Messaging	25%	Copy quality, headlines, value props, CTAs
Conversion Optimization	20%	Funnel design, forms, social proof, urgency
SEO & Discoverability	20%	On-page SEO, technical SEO, content structure
Competitive Positioning	15%	Differentiation, market awareness, alternatives
Brand & Trust	10%	Design quality, trust signals, authority
Growth & Strategy	10%	Pricing model, channels, retention

Overall Score = Weighted average (0-100 scale)

营销效果从6个加权维度进行评分：

类别	权重	评估标准
内容与Messaging	25%	文案质量、标题、价值主张、CTA
转化优化	20%	漏斗设计、表单、社交证明、紧迫感
SEO与可发现性	20%	页面SEO、技术SEO、内容结构
竞品定位	15%	差异化、市场认知度、替代方案
品牌与信任	10%	设计质量、信任信号、权威性
增长与策略	10%	定价模型、渠道、留存

总分 = 加权平均值（0-100分）

Configuration

配置

Environment Setup

环境设置

No API keys required — all analysis runs locally or via public web scraping.

For custom configurations, edit skill files:

bash

~/.claude/skills/market/SKILL.md

无需API密钥——所有分析均在本地运行或通过公开网页抓取完成。

如需自定义配置，编辑Skill文件：

bash

~/.claude/skills/market/SKILL.md

Custom Templates

自定义模板

Modify marketing templates in the

templates/

directory:

bash

templates/
├── email-welcome.md        # Welcome sequence template
├── email-nurture.md        # Lead nurture template
├── email-launch.md         # Product launch template
├── proposal-template.md    # Client proposal structure
├── content-calendar.md     # Content calendar format
└── launch-checklist.md     # Launch playbook structure

修改

templates/

目录下的营销模板：

bash

templates/
├── email-welcome.md        # 欢迎序列模板
├── email-nurture.md        # 线索培育模板
├── email-launch.md         # 产品发布模板
├── proposal-template.md    # 客户提案结构
├── content-calendar.md     # 内容日历格式
└── launch-checklist.md     # 发布手册结构

Common Workflows

常见工作流程

Agency Sales Flow

代理销售流程

bash

undefined

bash

undefined

1. Audit prospect's website

1. 审计潜在客户网站

/market audit https://prospect.com

2. Generate competitive analysis

2. 生成竞品分析

/market competitors https://prospect.com

3. Create proposal

3. 创建提案

/market proposal "B2B SaaS company needing content marketing"

/market proposal "B2B SaaS公司需要内容营销服务"

4. Generate PDF report for presentation

4. 生成用于演示的PDF报告

/market report-pdf https://prospect.com

undefined

/market report-pdf https://prospect.com

undefined

Product Launch

产品发布

bash

undefined

bash

undefined

1. Create launch playbook

1. 创建发布手册

/market launch "AI-powered email assistant"

/market launch "AI驱动的邮件助手"

2. Generate email sequence

2. 生成邮件序列

/market emails "Product launch for email assistant"

/market emails "邮件助手产品发布"

3. Build social calendar

3. 构建社交媒体日历

/market social "AI email assistant launch"

/market social "AI邮件助手发布"

4. Create ad campaigns

4. 创建广告活动

/market ads https://product-landing-page.com

undefined

/market ads https://product-landing-page.com

undefined

Website Optimization

网站优化

bash

undefined

bash

undefined

1. Run full audit

1. 运行完整审计

/market audit https://mysite.com

2. Analyze landing pages

2. 分析着陆页

/market landing https://mysite.com/pricing

3. Optimize copy

3. 优化文案

/market copy https://mysite.com

4. Check SEO

4. 检查SEO

/market seo https://mysite.com

undefined

/market seo https://mysite.com

undefined

Troubleshooting

故障排除

PDF Generation Fails

PDF生成失败

Problem:

/market report-pdf

command fails

Solution: Install reportlab

bash

pip install reportlab

问题：

/market report-pdf

命令执行失败

解决方案：安装reportlab

bash

pip install reportlab

Website Analysis Timeout

网站分析超时

Problem: Analysis hangs on large websites

Solution: Use

/market quick

for faster analysis or break into specific commands:

bash

/market seo https://example.com
/market copy https://example.com

问题：大型网站分析过程卡顿

解决方案：使用

/market quick

进行快速分析，或拆分执行特定命令：

bash

/market seo https://example.com
/market copy https://example.com

Skills Not Found

Skill未找到

Problem: Claude doesn't recognize

/market

commands

Solution: Verify installation

bash

ls -la ~/.claude/skills/market*
ls -la ~/.claude/agents/market-*

Re-run installer if needed:

bash

./install.sh

问题：Claude无法识别

/market

命令

解决方案：验证安装情况

bash

ls -la ~/.claude/skills/market*
ls -la ~/.claude/agents/market-*.md

如有需要，重新运行安装程序：

bash

./install.sh

Python Script Errors

Python脚本错误

Problem: Python scripts fail with import errors

Solution: Install all dependencies

bash

pip install -r requirements.txt

For specific scripts:

bash

pip install requests beautifulsoup4 reportlab

问题：Python脚本因导入错误执行失败

解决方案：安装所有依赖

bash

pip install -r requirements.txt

针对特定脚本：

bash

pip install requests beautifulsoup4 reportlab

Competitor Analysis Returns Empty

竞品分析返回空结果

Problem: No competitors found

Solution: Manually specify competitor URLs:

python

undefined

问题：未找到竞品

解决方案：手动指定竞品URL：

python

undefined

Edit scripts/competitor_scanner.py

编辑scripts/competitor_scanner.py

MANUAL_COMPETITORS = [ 'https://competitor1.com', 'https://competitor2.com' ]

undefined

MANUAL_COMPETITORS = [ 'https://competitor1.com', 'https://competitor2.com' ]

undefined

Uninstallation

卸载

Remove all marketing skills:

bash

./uninstall.sh

Or manually:

bash

rm -rf ~/.claude/skills/market*
rm -f ~/.claude/agents/market-*.md

移除所有营销Skill：

bash

./uninstall.sh

或手动移除：

bash

rm -rf ~/.claude/skills/market*
rm -f ~/.claude/agents/market-*.md

Best Practices

最佳实践

For Accurate Audits

确保审计准确性

Use full URLs including
```
https://
```
Ensure target website is publicly accessible
Run audits on primary landing pages, not deep subpages

使用包含
```
https://
```
的完整URL
确保目标网站可公开访问
在主着陆页而非深层子页面上运行审计

For Email Sequences

邮件序列生成建议

Be specific with topic (e.g., "SaaS trial to paid conversion" not "emails")
Specify audience segment when possible
Request specific sequence length (5, 7, or 10 emails)

明确主题（例如：“SaaS试用转付费转化”而非“邮件”）
尽可能指定受众群体
请求特定长度的序列（5、7或10封邮件）

For Client Deliverables

客户交付物建议

Always generate PDF reports for professional presentation
Combine multiple analyses (audit + competitors + proposal)
Customize templates before generation

始终生成PDF报告以呈现专业效果
结合多种分析结果（审计+竞品+提案）
生成前自定义模板

For Best Results

获取最佳结果

Run multiple specific commands rather than one generic command
Use
```
/market quick
```
first, then deep-dive with specific skills
Save all outputs before re-running analyses

运行多个特定命令而非单个通用命令
先使用
```
/market quick
```
，再通过特定Skill进行深入分析
重新运行分析前保存所有输出