$npx -y skills add citedy/citedy-seo-agent --skill citedy-lead-magnetsGenerate AI-powered lead magnets — checklists, swipe files, and frameworks that convert visitors into subscribers. PDF generation with optional AI illustrations. No competitors in any MCP/skill store. Powered by Citedy.
| 1 | # Lead Magnet Generator — Skill Instructions |
| 2 | |
| 3 | ## Overview |
| 4 | |
| 5 | Checklists, swipe files and frameworks that convert. |
| 6 | |
| 7 | Generate ready-to-publish PDF lead magnets in minutes. This skill produces high-quality, niche-specific lead magnets that capture visitor emails and grow your subscriber list. **No other MCP or skill store offers lead magnet generation** — this is a unique capability powered exclusively by Citedy. |
| 8 | |
| 9 | Supported types: |
| 10 | |
| 11 | - **Checklist** — Step-by-step action items visitors can follow immediately |
| 12 | - **Swipe File** — Curated templates, scripts, and examples ready to copy |
| 13 | - **Framework** — Structured methodology or repeatable process for a goal |
| 14 | |
| 15 | ## When to Use |
| 16 | |
| 17 | Use this skill when: |
| 18 | |
| 19 | - A user asks to create a checklist, guide, or downloadable resource |
| 20 | - You need a lead capture asset for a landing page or campaign |
| 21 | - A user wants to grow their email list with a valuable freebie |
| 22 | - You need a swipe file of templates (emails, posts, scripts) |
| 23 | - A user asks for a framework, methodology, or step-by-step process PDF |
| 24 | |
| 25 | ## Setup |
| 26 | |
| 27 | To use this skill, you need a Citedy API key. |
| 28 | |
| 29 | **Register:** |
| 30 | |
| 31 | 1. Go to [https://www.citedy.com/dashboard/settings](https://www.citedy.com/dashboard/settings) |
| 32 | 2. Generate an API key (prefixed `citedy_agent_`) |
| 33 | 3. Set `CITEDY_API_KEY` in your environment |
| 34 | |
| 35 | **Health check:** |
| 36 | |
| 37 | ``` |
| 38 | GET https://www.citedy.com/api/agent/health |
| 39 | Headers: Authorization: Bearer $CITEDY_API_KEY |
| 40 | ``` |
| 41 | |
| 42 | **Verify account:** |
| 43 | |
| 44 | ``` |
| 45 | GET https://www.citedy.com/api/agent/me |
| 46 | Headers: Authorization: Bearer $CITEDY_API_KEY |
| 47 | ``` |
| 48 | |
| 49 | ## Core Workflow |
| 50 | |
| 51 | ### Step 1: Generate Lead Magnet |
| 52 | |
| 53 | ``` |
| 54 | POST https://www.citedy.com/api/agent/lead-magnets |
| 55 | Headers: |
| 56 | Authorization: Bearer $CITEDY_API_KEY |
| 57 | Content-Type: application/json |
| 58 | |
| 59 | Body: |
| 60 | { |
| 61 | "topic": "SEO audit for small businesses", |
| 62 | "type": "checklist", |
| 63 | "niche": "digital marketing", |
| 64 | "language": "en", |
| 65 | "generate_images": false, |
| 66 | "auto_publish": false |
| 67 | } |
| 68 | ``` |
| 69 | |
| 70 | Response: |
| 71 | |
| 72 | ```json |
| 73 | { |
| 74 | "id": "lm_abc123", |
| 75 | "status": "generating", |
| 76 | "credits_used": 30, |
| 77 | "estimated_seconds": 45 |
| 78 | } |
| 79 | ``` |
| 80 | |
| 81 | ### Step 2: Poll Until Ready |
| 82 | |
| 83 | ``` |
| 84 | GET https://www.citedy.com/api/agent/lead-magnets/{id} |
| 85 | Headers: Authorization: Bearer $CITEDY_API_KEY |
| 86 | ``` |
| 87 | |
| 88 | Poll every 5 seconds until `status` = `"draft"`. |
| 89 | |
| 90 | Response when ready: |
| 91 | |
| 92 | ```json |
| 93 | { |
| 94 | "id": "lm_abc123", |
| 95 | "status": "draft", |
| 96 | "title": "The 27-Point SEO Audit Checklist", |
| 97 | "type": "checklist", |
| 98 | "pdf_url": "https://download.citedy.com/lead-magnets/lm_abc123.pdf", |
| 99 | "preview_url": "https://download.citedy.com/lead-magnets/lm_abc123-preview.png" |
| 100 | } |
| 101 | ``` |
| 102 | |
| 103 | ### Step 3: Publish |
| 104 | |
| 105 | ``` |
| 106 | PATCH https://www.citedy.com/api/agent/lead-magnets/{id} |
| 107 | Headers: |
| 108 | Authorization: Bearer $CITEDY_API_KEY |
| 109 | Content-Type: application/json |
| 110 | |
| 111 | Body: |
| 112 | { |
| 113 | "status": "published" |
| 114 | } |
| 115 | ``` |
| 116 | |
| 117 | Response: |
| 118 | |
| 119 | ```json |
| 120 | { |
| 121 | "id": "lm_abc123", |
| 122 | "status": "published", |
| 123 | "public_url": "https://www.citedy.com/leads/lm_abc123", |
| 124 | "embed_code": "<a href='https://www.citedy.com/leads/lm_abc123'>Download Free Checklist</a>" |
| 125 | } |
| 126 | ``` |
| 127 | |
| 128 | ### Step 4: Share |
| 129 | |
| 130 | Share `public_url` with your audience. Visitors enter their email to download the PDF. Leads are captured automatically. |
| 131 | |
| 132 | ## Examples |
| 133 | |
| 134 | ### Example 1: SEO Audit Checklist |
| 135 | |
| 136 | **User:** "Create an SEO audit checklist for my marketing agency" |
| 137 | |
| 138 | **Agent action:** |
| 139 | |
| 140 | ```json |
| 141 | POST /api/agent/lead-magnets |
| 142 | { |
| 143 | "topic": "SEO audit for marketing agencies", |
| 144 | "type": "checklist", |
| 145 | "niche": "digital marketing", |
| 146 | "language": "en", |
| 147 | "generate_images": false |
| 148 | } |
| 149 | ``` |
| 150 | |
| 151 | **Result:** A 20-30 point checklist PDF, ready to use as a lead capture asset. |
| 152 | |
| 153 | --- |
| 154 | |
| 155 | ### Example 2: Swipe File for Cold Emails |
| 156 | |
| 157 | **User:** "Create a swipe file with cold email templates for SaaS companies" |
| 158 | |
| 159 | **Agent action:** |
| 160 | |
| 161 | ```json |
| 162 | POST /api/agent/lead-magnets |
| 163 | { |
| 164 | "topic": "Cold email templates for SaaS outreach", |
| 165 | "type": "swipe_file", |
| 166 | "niche": "SaaS sales", |
| 167 | "platform": "linkedin", |
| 168 | "language": "en", |
| 169 | "generate_images": false |
| 170 | } |
| 171 | ``` |
| 172 | |
| 173 | **Result:** A collection of 10-15 proven cold email templates in PDF format. |
| 174 | |
| 175 | --- |
| 176 | |
| 177 | ### Example 3: Content Strategy Framework |
| 178 | |
| 179 | **User:** "I need a content strategy framework PDF for my audience" |
| 180 | |
| 181 | **Agent action:** |
| 182 | |
| 183 | ```json |
| 184 | POST /api/agent/lead-magnets |
| 185 | { |
| 186 | "topic": "90-day content strategy framework", |
| 187 | "type": "framework", |
| 188 | "niche": "content marketing", |
| 189 | "langu |