astro-cta-injector

Astro CTA 注入技能

用途

此技能可将行动号召（CTA）区块注入 Astro 网站内容。它支持：

• 多种 CTA 类型（newsletter、产品、自定义）
• 智能放置策略
• 基于内容的相关性评分
• 带预览的批量处理

何时使用此技能

• 用户要求“为博客文章添加 CTA”
• 用户希望在内容中“注入 newsletter 注册表单”
• 用户提到要在文章中“添加产品推广”
• 用户需要批量向文章添加任意类型的内容区块
• 用户希望“向 Astro 网站添加行动号召”

前提条件

• Astro 网站，内容位于 .astro 或 .md 文件中
• Python 3.10+
• 用于 HTML 解析的 BeautifulSoup4

配置

在技能目录中创建一个 config.json：

{
  "content_path": "./src/content/blog",
  "file_patterns": ["*.astro", "*.md"],
  "cta_types": {
    "newsletter": {
      "template": "newsletter.html",
      "default_placement": "after-paragraph-50%",
      "keywords": ["tip", "guide", "learn", "strategy"]
    },
    "product": {
      "template": "product.html",
      "default_placement": "end",
      "keywords": ["productivity", "task", "habit", "goal"]
    }
  },
  "output": {
    "state_file": "./state/cta_injection_progress.json",
    "backup_dir": "./backups",
    "report_file": "./reports/cta_injection_report.md"
  },
  "dry_run": true
}

放置策略

策略	说明	最适合
end	所有内容之后	不打扰读者的 CTA
after-paragraph-50%	在 50% 的段落之后	在内容中段吸引互动
after-paragraph-60%	在 60% 的段落之后	在内容后段吸引互动
after-heading	第一个 H2 之后	尽早吸引互动
before-conclusion	最后一段之前	强有力的收尾

CTA 模板

模板是 templates/ 目录中的 HTML 文件：

<aside class="cta-newsletter" data-cta-type="newsletter">
  <h3>{{title}}</h3>
  <p>{{description}}</p>
  <form action="{{form_url}}" method="post">
    <input type="email" placeholder="Your email" required />
    <button type="submit">Subscribe</button>
  </form>
</aside>

变量：

• {{title}} - CTA 标题
• {{description}} - CTA 正文
• {{form_url}} - 表单提交 URL
• {{product_url}} - 产品链接
• {{image_url}} - 图片来源

工作流

步骤 1：评估文章的相关性

python scripts/score_posts.py --content-path ./src/content/blog --cta-type newsletter

步骤 2：预览注入效果

python scripts/preview_injection.py --input scored_posts.json --cta-type newsletter

步骤 3：应用注入

python scripts/inject_ctas.py --input scored_posts.json --cta-type newsletter

输入格式

已评分文章的 JSON：

{
  "posts": [
    {
      "file_path": "./src/content/blog/my-post.astro",
      "title": "My Blog Post",
      "relevance_score": 8.5,
      "cta_type": "newsletter",
      "placement": "after-paragraph-50%",
      "cta_data": {
        "title": "Get More Tips Like This",
        "description": "Subscribe to my weekly newsletter"
      }
    }
  ]
}

评分算法

根据 CTA 相关性对文章评分，依据如下：

1. 关键词密度 - 出现了多少个相关关键词
2. 内容长度 - 文章越长，越适合作为候选
3. 主题匹配度 - 标题与内容的主题一致性
4. 现有 CTA - 跳过已有 CTA 的文章

评分范围为 0-10。默认阈值：5.0

安全功能

• 默认启用试运行模式
• 修改前创建备份
• 重复项检测 - 如果 CTA 已存在，则不会注入
• 回滚功能 - 从备份中恢复
• 差异预览 - 精确查看将要发生的更改

使用示例

用户：“为我所有与效率相关的博客文章添加 newsletter 注册 CTA”

Claude 将会：

1. 扫描内容目录中的文章
2. 使用效率关键词为文章评估“newsletter”相关性
3. 根据模板生成 CTA HTML
4. 显示更改预览
5. 请求确认
6. 向匹配的文章注入 CTA
7. 报告结果