mcpField
N
newsletter-publishing

newsletter-publishing

github.com/jamditisマーケティング・グロース438253 回インストール4 日前に更新
リポジトリ

newsletter-publishing について

newsletter-publishingは、報道機関や学術チーム向けのメールニュースレター運営スキルです。編集構成、購読者管理、到達性、分析、法令遵守、プラットフォーム選定を扱います。

主な機能

  1. 01ニュースレター戦略と号のテンプレート
  2. 02レスポンシブHTMLメールの指針
  3. 03購読者リストの整理とセグメント化
  4. 04件名のテストと最適化
  5. 05到達性とコンプライアンスの確認
  6. 06指標分析とプラットフォーム比較

活用シーン

  1. 01出版物のニュースレター企画
  2. 02購読者リストの分類と整理
  3. 03認証設定と配信停止要件の確認
  4. 04移行前のニュースレタープラットフォーム比較

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jamditis/claude-skills-journalism --skill newsletter-publishing

インストール後、Claude Code で/newsletter-publishingを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yaml

詳細

ニュースレターの配信

ジャーナリズムや学術分野向けのメールニュースレターを作成・管理するための実践的なワークフローです。

使用するタイミング

  • 新しいニュースレターをゼロから作成するとき
  • ジャーナリズム向けコンテンツのメールテンプレートを設計するとき
  • 購読者リストを作成し、セグメント化するとき
  • ニュースレターのパフォーマンス指標を分析するとき
  • ニュースレターの編集カレンダーを計画するとき
  • ニュースレタープラットフォームを移行するとき
  • メールの到達率と開封率を改善するとき

ニュースレターのアーキテクチャ

コンテンツ戦略のフレームワーク
## Newsletter strategy document

### Core identity
- **Name**:
- **Tagline** (one line):
- **What readers get**: [specific value proposition]
- **Frequency**: [ ] Daily [ ] Weekly [ ] Bi-weekly [ ] Monthly

### Target audience
- Primary reader:
- What they care about:
- Why they'll subscribe:
- What they'll do with this info:

### Content pillars
1. [Core topic 1] - [how often]
2. [Core topic 2] - [how often]
3. [Recurring feature] - [how often]

### Voice and tone
- Formal ↔ Conversational: [1-5]
- Serious ↔ Light: [1-5]
- Reported ↔ Personal: [1-5]

### Success metrics (first 6 months)
- Subscriber goal:
- Target open rate:
- Target click rate:
配信号の構成テンプレート
## [Newsletter Name] - Issue #[XX]
**Date**: [Date]
**Subject line**: [Subject]
**Preview text**: [First 50-90 characters readers see]

---

### Opening hook
[2-3 sentences that make readers want to keep reading]

### Main story
[Your primary content - 300-600 words for most newsletters]

### Secondary items (if applicable)
- **Quick hit 1**: [Brief item with link]
- **Quick hit 2**: [Brief item with link]

### Recurring section
[Weekly column, data point, recommendation, etc.]

### Sign-off
[Personal note, call to action, or preview of next issue]

---

**Unsubscribe** | **Preferences** | **Forward to a friend**

技術的な実装

HTMLメールテンプレート(レスポンシブ)
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>{{newsletter_name}}</title>
  <style>
    /* Reset styles for email clients */
    body { margin: 0; padding: 0; width: 100%; }
    table { border-collapse: collapse; }
    img { border: 0; display: block; }

    /* Responsive container */
    .container {
      max-width: 600px;
      margin: 0 auto;
      font-family: Georgia, serif;
      font-size: 18px;
      line-height: 1.6;
      color: #333;
    }

    /* Dark mode support */
    @media (prefers-color-scheme: dark) {
      .container { background-color: #1a1a1a; color: #e0e0e0; }
      a { color: #6db3f2; }
    }

    /* Mobile styles */
    @media only screen and (max-width: 480px) {
      .container { padding: 15px !important; }
      h1 { font-size: 24px !important; }
    }
  </style>
</head>
<body>
  <table role="presentation" width="100%">
    <tr>
      <td align="center" style="padding: 20px;">
        <div class="container">
          
          <table width="100%">
            <tr>
              <td style="padding-bottom: 20px; border-bottom: 2px solid #333;">
                <h1 style="margin: 0;">{{newsletter_name}}</h1>
                <p style="margin: 5px 0 0; color: #666;">{{issue_date}}</p>
              </td>
            </tr>
          </table>

          
          <table width="100%">
            <tr>
              <td style="padding: 30px 0;">
                {{content}}
              </td>
            </tr>
          </table>

          
          <table width="100%">
            <tr>
              <td style="padding-top: 20px; border-top: 1px solid #ddd; font-size: 14px; color: #666;">
                <p>You're receiving this because you subscribed to {{newsletter_name}}.</p>
                <p>
                  <a href="{{unsubscribe_url}}">Unsubscribe</a> |
                  <a href="{{preferences_url}}">Update preferences</a>
                </p>
              </td>
            </tr>
          </table>
        </div>
      </td>
    </tr>
  </table>
</body>
</html>
Python製ニュースレター送信ツール
from dataclasses import dataclass, field
from datetime import datetime
from typing import List, Dict, Optional
from enum import Enum
import hashlib

class SubscriberStatus(Enum):
    ACTIVE = "active"
    UNSUBSCRIBED = "unsubscribed"
    BOUNCED = "bounced"
    COMPLAINED = "complained"

@dataclass
class Subscriber:
    email: str
    name: Optional[str] = None
    subscribed_at: datetime = field(default_factory=datetime.now)
    status: SubscriberStatus = SubscriberStatus.ACTIVE
    tags: List[str] = field(default_factory=list)
    custom_fields: Dict = field(default_factory=dict)

    @property
    def hash_id(self) -> str:
        """Generate unique ID for unsubscribe links."""
        return hashlib.md5(self.email.encode()).hexdigest()[:12]

@dataclass
class NewsletterIssue:
    subject: str
    preview_text: str
    html_content: str
    plain_text: str
    scheduled_at: Optional[datetime] = None
    sent_at: Optional[datetime] = None
    issue_number: int = 0

    # Metrics
    sent_count: int = 0
    delivered_count: int = 0
    opened_count: int = 0
    clicked_count: int = 0
    bounced_count: int = 0
    unsubscribed_count: int = 0

    @property
    def open_rate(self) -> float:
        if self.delivered_count == 0:
            return 0.0
        return (self.opened_count / self.delivered_count) * 100

    @property
    def click_rate(self) -> float:
        if self.delivered_count == 0:
            return 0.0
        return (self.clicked_count / self.delivered_count) * 100

class NewsletterManager:
    """Core newsletter operations."""

    def __init__(self, name: str):
        self.name = name
        self.subscribers: List[Subscriber] = []
        self.issues: List[NewsletterIssue] = []

    def add_subscriber(self, email: str, name: str = None,
                       tags: List[str] = None) -> Subscriber:
        """Add new subscriber with double opt-in pending."""
        sub = Subscriber(
            email=email.lower().strip(),
            name=name,
            tags=tags or []
        )
        self.subscribers.append(sub)
        return sub

    def segment_subscribers(self, tags: List[str] = None,
                           min_engagement: float = None) -> List[Subscriber]:
        """Get subscribers matching criteria."""
        active = [s for s in self.subscribers
                  if s.status == SubscriberStatus.ACTIVE]

        if tags:
            active = [s for s in active
                     if any(t in s.tags for t in tags)]

        return active

    def calculate_engagement_score(self, subscriber: Subscriber) -> float:
        """Score subscriber engagement 0-100."""
        # Implementation would track opens/clicks per subscriber
        return 50.0  # Placeholder

購読者の管理

リストの整理ワークフロー
from datetime import datetime, timedelta

def clean_subscriber_list(manager: NewsletterManager,
                         inactive_threshold_days: int = 180) -> dict:
    """Identify and handle inactive subscribers."""
    cutoff = datetime.now() - timedelta(days=inactive_threshold_days)

    results = {
        'total': len(manager.subscribers),
        'active': 0,
        'inactive': [],
        'bounced': [],
        'unsubscribed': []
    }

    for sub in manager.subscribers:
        if sub.status == SubscriberStatus.BOUNCED:
            results['bounced'].append(sub.email)
        elif sub.status == SubscriberStatus.UNSUBSCRIBED:
            results['unsubscribed'].append(sub.email)
        elif sub.status == SubscriberStatus.ACTIVE:
            # Check last engagement
            engagement = manager.calculate_engagement_score(sub)
            if engagement < 10:  # Very low engagement
                results['inactive'].append(sub.email)
            else:
                results['active'] += 1

    return results

def run_reengagement_campaign(inactive_subscribers: List[str]) -> None:
    """Send win-back campaign to inactive subscribers."""
    # Send "We miss you" campaign
    # If no engagement after 2 attempts, mark for removal
    pass
購読者のセグメント化
## Recommended segments

### By engagement
- **VIPs**: Open rate > 80%, always click
- **Engaged**: Open rate 40-80%
- **Casual**: Open rate 10-40%
- **At-risk**: Haven't opened in 90 days
- **Inactive**: Haven't opened in 180 days

### By interest (tag-based)
- Topic preferences from signup
- Content they've clicked
- Surveys/polls they've answered

### By source
- Organic (website signup)
- Referral (forwarded by friend)
- Social media
- Paywall/registration wall

件名の最適化

高い成果を上げるパターン
## Subject line formulas that work

### For news/journalism
- **Breaking format**: "Breaking: [Concise news]"
- **Numbers**: "[X] things we learned about [topic]"
- **Question**: "Why did [entity] do [thing]?"
- **Direct**: "[Topic]: What you need to know"

### For analysis/opinion
- **Take**: "The real story behind [event]"
- **Contrarian**: "Why everyone is wrong about [topic]"
- **Insider**: "What [industry] insiders know about [topic]"

### What to avoid
- ALL CAPS
- Excessive punctuation!!!
- Clickbait that doesn't deliver
- Spam trigger words (FREE, URGENT, ACT NOW)
- Misleading preview text
A/Bテストのフレームワーク
import random
from typing import List, Tuple

def ab_test_subject_lines(subscribers: List[Subscriber],
                         subject_a: str,
                         subject_b: str,
                         test_percentage: float = 0.2) -> dict:
    """
    Test two subject lines on subset before full send.
    """
    test_size = int(len(subscribers) * test_percentage)
    test_group = random.sample(subscribers, test_size)

    # Split test group
    half = len(test_group) // 2
    group_a = test_group[:half]
    group_b = test_group[half:]

    remaining = [s for s in subscribers if s not in test_group]

    return {
        'group_a': {
            'subject': subject_a,
            'subscribers': group_a,
            'size': len(group_a)
        },
        'group_b': {
            'subject': subject_b,
            'subscribers': group_b,
            'size': len(group_b)
        },
        'remaining': {
            'subscribers': remaining,
            'size': len(remaining),
            'note': 'Send winner to this group after test period'
        },
        'test_duration_hours': 4
    }

到達率を高めるためのベストプラクティス

メール認証の設定
## DNS records for deliverability

### SPF record

v=spf1 include:_spf.{{esp_sending_domain}} ~all


### DKIM
- Generate keys through your ESP
- Add TXT record with public key
- Verify signature is applied to outgoing mail

### DMARC

v=DMARC1; p=quarantine; rua=mailto:[email protected]


### Checklist before sending
- [ ] SPF, DKIM, DMARC configured
- [ ] Sending domain warmed up
- [ ] List is clean (no hard bounces)
- [ ] Unsubscribe link works
- [ ] Physical address in footer (CAN-SPAM)
- [ ] Test email received in inbox (not spam)
Gmail、Yahoo、Outlookの一斉送信者向け要件

一斉送信者は、2024年2月にGmailとYahooが導入した認証および配信停止の要件を満たす必要があります。Microsoft Outlookも2025年5月に同様の要件を導入しました。2025年11月以降、Gmailは要件に準拠しないメールを一時的に保留せず、恒久的な5xxエラーで拒否するようになったため、準拠しないニュースレターはハードバウンスするようになりました。

対象者。 1日にGmailアドレス宛てに5,000通を超えるメールを送信する送信者は「一斉送信者」に該当します。この5,000通の基準は、送信元サブドメインごとではなく、すべてのサブドメインを含むプライマリドメイン単位で数えます。transactional.example.comから1日2,500通、news.example.comから1日2,500通を送信するニュースルームは、基準を超えています。

必須要件:

  • 送信ドメインでのSPFおよびDKIM認証。 両方に合格する必要があります。SPFだけでは不十分です。DKIM鍵は少なくとも1024ビットでなければなりません。
  • 最低限p=noneのDMARCポリシー。 本番環境の送信者は、整合性が取れたらp=quarantineまたはp=rejectに移行する必要があります。
  • ドメインの整合性。 SPFまたはDKIMのいずれか一方が、表示されるFrom:ヘッダー内の組織ドメインと整合している必要があります。両方が整合している必要はありません。緩和された整合性で問題ありません。
  • ワンクリック配信停止(RFC 8058)。 メールには、HTTPS URLを含むList-Unsubscribeヘッダーと、List-Unsubscribe-Post: List-Unsubscribe=One-Clickヘッダーを含める必要があります。HTTPSエンドポイントは、ログインを要求せずに2日以内に配信停止を処理しなければなりません。また、メッセージ本文にも、目に見える配信停止リンクを含める必要があります。
  • 迷惑メールの苦情率を0.3%未満にすること。 Google Postmaster Toolsで測定します。Googleが推奨する上限目標は0.1%です。0.3%を超える状態が続くと、メールが拒否されます。
  • 送信IPに有効なPTRレコード(逆引きDNS)があること。 正引きDNSと逆引きDNSが一致している必要があります。
  • 受信接続にTLSを使用すること(Googleの要件。2023年12月より適用)。

運用上の影響:

評判の良いESPのほとんどは、送信ドメインの確認後、認証、ヘッダー、TLSを処理します。運用者の責任として残るのは、苦情率と配信停止の動作の2点です。ここでは、再エンゲージメントキャンペーンと、速やかなリストの整理が重要です。休眠中の購読者はアクティブな購読者の5~10倍の割合で苦情を申し立てるため、休眠中の購読者との再エンゲージメントには特にリスクがあります。再エンゲージメントキャンペーンが一度失敗しただけで、苦情率が0.3%を超え、送信ドメイン全体でメールが拒否される可能性があります。

参考資料:

  • Google、『メール送信者向けガイドライン』、support.google.com/mail/answer/81126
  • Google、『メール送信者向けガイドラインに関するよくある質問』、support.google.com/a/answer/14229414
  • Yahoo、『送信者向けベストプラクティス』、senders.yahooinc.com/best-practices/
迷惑メールスコアのチェックリスト
## Before you send

### Content checks
- [ ] No spam trigger words
- [ ] Text-to-image ratio good (mostly text)
- [ ] All links are to reputable domains
- [ ] No URL shorteners (use full links)
- [ ] Plain text version included

### Technical checks
- [ ] From address matches sending domain
- [ ] Reply-to address is monitored
- [ ] Preheader text is set
- [ ] Images have alt text
- [ ] Links are not broken

分析と最適化

主要指標ダッシュボード
from dataclasses import dataclass

@dataclass
class NewsletterAnalytics:
    """Track newsletter performance over time."""

    issue: NewsletterIssue

    def summary(self) -> dict:
        return {
            'issue_number': self.issue.issue_number,
            'sent': self.issue.sent_count,
            'delivered': self.issue.delivered_count,
            'delivery_rate': self._pct(self.issue.delivered_count,
                                       self.issue.sent_count),
            'opens': self.issue.opened_count,
            'open_rate': self.issue.open_rate,
            'clicks': self.issue.clicked_count,
            'click_rate': self.issue.click_rate,
            'click_to_open': self._pct(self.issue.clicked_count,
                                       self.issue.opened_count),
            'unsubscribes': self.issue.unsubscribed_count,
            'unsubscribe_rate': self._pct(self.issue.unsubscribed_count,
                                          self.issue.delivered_count),
        }

    def _pct(self, numerator: int, denominator: int) -> float:
        if denominator == 0:
            return 0.0
        return round((numerator / denominator) * 100, 2)

# Benchmarks (journalism newsletters)
BENCHMARKS = {
    'open_rate': {'good': 40, 'excellent': 55},
    'click_rate': {'good': 4, 'excellent': 8},
    'unsubscribe_rate': {'acceptable': 0.5, 'concerning': 1.0},
}

プラットフォームの比較

プラットフォーム最適な用途料金モデル主な機能
Substackライターを重視し、有料購読を提供収益分配決済機能を内蔵
Buttondown開発者、ミニマルな運用購読者数に応じた料金Markdown に標準対応
Ghost出版社、会員制定額料金CMS をフル機能で搭載
beehiiv成長を重視フリーミアム紹介ツール
Kit(旧 ConvertKit)クリエイター購読者数に応じた料金自動化
Mailchimp小規模組織段階制簡単に使えるテンプレート

法令遵守

CAN-SPAM の要件(米国)
- [ ] Accurate "From" name and email
- [ ] Non-deceptive subject line
- [ ] Physical postal address included
- [ ] Working unsubscribe mechanism
- [ ] Unsubscribe honored within 10 days
- [ ] No purchased lists
GDPR の要件(EU の購読者)
- [ ] Explicit consent obtained (not pre-checked)
- [ ] Clear privacy policy linked
- [ ] Easy unsubscribe process
- [ ] Data export available on request
- [ ] Data deletion on request
- [ ] Record of consent stored

関連スキル

  • web-scraping、ニュースレター用のコンテンツ収集を自動化します
  • data-journalism、メールにデータビジュアライゼーションを取り入れます
  • academic-writing、明確で構成の整ったコンテンツを作成します
  • newsroom-style、ニュースレターの原稿に AP スタイルを適用します
  • fact-check-workflow、購読者の受信トレイに届く前に主張を検証します
  • ai-writing-detox、下書きから AI らしい表現を取り除きます

スキルのメタデータ

項目値
version1.0.0
created2025-12-26
updated2026-05-08
authorJoe Amditis
domainpublishing, marketing
complexityintermediate

コメント