AGENT SKILL

mailchimp

Complete guide to all Mailchimp tools — campaigns, audiences, lists, templates, segments, and email marketing.

License 许可
MIT
最近更新
2026-10-27
Stars
★ 0
Forks
1

01 前言 Front Matter

name
mailchimp
license
MIT
version
1.0.0
metadata
{ "tags": "mailchimp,email,campaigns,marketing,audiences", "author": "Matimo", "apply-to": "mailchimp-create-campaign mailchimp-send-campaign mailchimp-get-campaign mailchimp-list-campaigns mailchimp-add-member mailchimp-list-members mailchimp-get-member", "category": "Marketing", "difficulty": "intermediate" }
description
Complete guide to all Mailchimp tools — campaigns, audiences, lists, templates, segments, and email marketing.

03 SKILL.md 正文

Mailchimp

Complete guide to using Matimo's Mailchimp tools for campaign management, audience operations, and email marketing.

All Available Tools

Tool Purpose Category
mailchimp-create-campaign Create a new campaign Campaigns
mailchimp-send-campaign Send or schedule a campaign Campaigns
mailchimp-get-campaign Get campaign details and stats Campaigns
mailchimp-list-campaigns List campaigns with filters Campaigns
mailchimp-add-member Add a subscriber to an audience Audiences
mailchimp-list-members List subscribers in an audience Audiences
mailchimp-get-member Get subscriber details Audiences

Authentication

Requires MAILCHIMP_API_KEY (format: key-dc, where dc is the data center, e.g., abc123-us21).


Campaigns

Creating Campaigns

Use mailchimp-create-campaign with:

  • type — regular, plaintext, absplit, or rss
  • recipients — { "list_id": "..." } (required audience)
  • settings — subject_line, from_name, reply_to, title
{
  "type": "regular",
  "recipients": { "list_id": "abc123" },
  "settings": {
    "subject_line": "Weekly Newsletter",
    "from_name": "Acme Team",
    "reply_to": "team@acme.com"
  }
}

Sending Campaigns

Use mailchimp-send-campaign with campaign_id. Ensure campaign has content and recipients before sending.

Pre-send checklist:

  1. Campaign has content (template or HTML)
  2. Recipients/audience set
  3. Subject line and from address configured
  4. Test email sent

Campaign Stats

Use mailchimp-get-campaign to retrieve delivery stats: emails_sent, opens, clicks, bounces, unsubscribes.


Audiences (Lists)

Adding Members

Use mailchimp-add-member with:

  • list_id (required) — the audience ID
  • email_address (required) — subscriber email
  • status — subscribed, unsubscribed, cleaned, pending
  • merge_fields — { "FNAME": "Alice", "LNAME": "Smith" }

Best practices:

  • Always use pending status for double opt-in compliance
  • Set merge fields for personalization
  • Check for existing subscribers before adding

Listing Members

Use mailchimp-list-members with list_id and optional status, count, offset for pagination.

Getting Member Details

Use mailchimp-get-member with list_id and subscriber_hash (MD5 of lowercase email) or email_address.


Common Workflows

Newsletter Campaign

  1. Add new subscribers: mailchimp-add-member with status: "pending"
  2. Create campaign: mailchimp-create-campaign
  3. Send campaign: mailchimp-send-campaign
  4. Check results: mailchimp-get-campaign for stats

Audience Growth Tracking

  1. List members: mailchimp-list-members with different statuses
  2. Monitor subscriber counts over time
  3. Review bounce and unsubscribe rates

Common Errors

Error Cause Fix
401 API Key Invalid Wrong API key or data center Check key format key-dc
400 Member Exists Email already in audience Use update instead of add
400 Campaign Not Ready Missing content or recipients Complete all required fields
429 Too Many Requests Rate limit (10 concurrent connections) Implement backoff
404 Resource Not Found Invalid list_id or campaign_id Verify IDs

04 同仓库更多 Skills