{"id":"1cd10031-183d-49e0-aa05-859bd25bd651","shortId":"WuWrdv","kind":"skill","title":"citedy-lead-magnets","tagline":"Generate 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.","description":"# Lead Magnet Generator — Skill Instructions\n\n## Overview\n\nChecklists, swipe files and frameworks that convert.\n\nGenerate 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.\n\nSupported types:\n\n- **Checklist** — Step-by-step action items visitors can follow immediately\n- **Swipe File** — Curated templates, scripts, and examples ready to copy\n- **Framework** — Structured methodology or repeatable process for a goal\n\n## When to Use\n\nUse this skill when:\n\n- A user asks to create a checklist, guide, or downloadable resource\n- You need a lead capture asset for a landing page or campaign\n- A user wants to grow their email list with a valuable freebie\n- You need a swipe file of templates (emails, posts, scripts)\n- A user asks for a framework, methodology, or step-by-step process PDF\n\n## Setup\n\nTo use this skill, you need a Citedy API key.\n\n**Register:**\n\n1. Go to [https://www.citedy.com/dashboard/settings](https://www.citedy.com/dashboard/settings)\n2. Generate an API key (prefixed `citedy_agent_`)\n3. Set `CITEDY_API_KEY` in your environment\n\n**Health check:**\n\n```\nGET https://www.citedy.com/api/agent/health\nHeaders: Authorization: Bearer $CITEDY_API_KEY\n```\n\n**Verify account:**\n\n```\nGET https://www.citedy.com/api/agent/me\nHeaders: Authorization: Bearer $CITEDY_API_KEY\n```\n\n## Core Workflow\n\n### Step 1: Generate Lead Magnet\n\n```\nPOST https://www.citedy.com/api/agent/lead-magnets\nHeaders:\n  Authorization: Bearer $CITEDY_API_KEY\n  Content-Type: application/json\n\nBody:\n{\n  \"topic\": \"SEO audit for small businesses\",\n  \"type\": \"checklist\",\n  \"niche\": \"digital marketing\",\n  \"language\": \"en\",\n  \"generate_images\": false,\n  \"auto_publish\": false\n}\n```\n\nResponse:\n\n```json\n{\n  \"id\": \"lm_abc123\",\n  \"status\": \"generating\",\n  \"credits_used\": 30,\n  \"estimated_seconds\": 45\n}\n```\n\n### Step 2: Poll Until Ready\n\n```\nGET https://www.citedy.com/api/agent/lead-magnets/{id}\nHeaders: Authorization: Bearer $CITEDY_API_KEY\n```\n\nPoll every 5 seconds until `status` = `\"draft\"`.\n\nResponse when ready:\n\n```json\n{\n  \"id\": \"lm_abc123\",\n  \"status\": \"draft\",\n  \"title\": \"The 27-Point SEO Audit Checklist\",\n  \"type\": \"checklist\",\n  \"pdf_url\": \"https://download.citedy.com/lead-magnets/lm_abc123.pdf\",\n  \"preview_url\": \"https://download.citedy.com/lead-magnets/lm_abc123-preview.png\"\n}\n```\n\n### Step 3: Publish\n\n```\nPATCH https://www.citedy.com/api/agent/lead-magnets/{id}\nHeaders:\n  Authorization: Bearer $CITEDY_API_KEY\n  Content-Type: application/json\n\nBody:\n{\n  \"status\": \"published\"\n}\n```\n\nResponse:\n\n```json\n{\n  \"id\": \"lm_abc123\",\n  \"status\": \"published\",\n  \"public_url\": \"https://www.citedy.com/leads/lm_abc123\",\n  \"embed_code\": \"<a href='https://www.citedy.com/leads/lm_abc123'>Download Free Checklist</a>\"\n}\n```\n\n### Step 4: Share\n\nShare `public_url` with your audience. Visitors enter their email to download the PDF. Leads are captured automatically.\n\n## Examples\n\n### Example 1: SEO Audit Checklist\n\n**User:** \"Create an SEO audit checklist for my marketing agency\"\n\n**Agent action:**\n\n```json\nPOST /api/agent/lead-magnets\n{\n  \"topic\": \"SEO audit for marketing agencies\",\n  \"type\": \"checklist\",\n  \"niche\": \"digital marketing\",\n  \"language\": \"en\",\n  \"generate_images\": false\n}\n```\n\n**Result:** A 20-30 point checklist PDF, ready to use as a lead capture asset.\n\n---\n\n### Example 2: Swipe File for Cold Emails\n\n**User:** \"Create a swipe file with cold email templates for SaaS companies\"\n\n**Agent action:**\n\n```json\nPOST /api/agent/lead-magnets\n{\n  \"topic\": \"Cold email templates for SaaS outreach\",\n  \"type\": \"swipe_file\",\n  \"niche\": \"SaaS sales\",\n  \"platform\": \"linkedin\",\n  \"language\": \"en\",\n  \"generate_images\": false\n}\n```\n\n**Result:** A collection of 10-15 proven cold email templates in PDF format.\n\n---\n\n### Example 3: Content Strategy Framework\n\n**User:** \"I need a content strategy framework PDF for my audience\"\n\n**Agent action:**\n\n```json\nPOST /api/agent/lead-magnets\n{\n  \"topic\": \"90-day content strategy framework\",\n  \"type\": \"framework\",\n  \"niche\": \"content marketing\",\n  \"language\": \"en\",\n  \"generate_images\": true,\n  \"auto_publish\": true\n}\n```\n\n**Result:** A structured PDF framework with visual diagrams and step-by-step methodology. Published immediately with a shareable link.\n\n## API Reference\n\n### POST /api/agent/lead-magnets\n\nGenerate a new lead magnet.\n\n| Field             | Type    | Required | Description                                                |\n| ----------------- | ------- | -------- | ---------------------------------------------------------- |\n| `topic`           | string  | Yes      | Topic or subject of the lead magnet                        |\n| `type`            | string  | Yes      | `checklist`, `swipe_file`, or `framework`                  |\n| `niche`           | string  | No       | Target niche for more specific content                     |\n| `language`        | string  | No       | `en`, `pt`, `de`, `es`, `fr`, `it` (default: `en`)         |\n| `platform`        | string  | No       | `twitter` or `linkedin` — optimizes tone                   |\n| `generate_images` | boolean | No       | Include AI-generated illustrations (default: `false`)      |\n| `auto_publish`    | boolean | No       | Skip draft step and publish immediately (default: `false`) |\n\n**Credits:** 30 credits text-only, 100 credits with images\n\n---\n\n### GET /api/agent/lead-magnets/{id}\n\nPoll for generation status.\n\n**Credits:** 0 credits (free)\n\nResponse fields:\n| Field | Description |\n|---|---|\n| `id` | Lead magnet ID |\n| `status` | `generating`, `draft`, `published`, `failed` |\n| `title` | Generated title |\n| `type` | checklist / swipe_file / framework |\n| `pdf_url` | Direct PDF download URL (when status = draft or published) |\n| `preview_url` | Preview image URL |\n| `public_url` | Public lead capture page (when status = published) |\n\n---\n\n### PATCH /api/agent/lead-magnets/{id}\n\nUpdate lead magnet (publish or update metadata).\n\n**Credits:** 0 credits (free)\n\n| Field    | Type   | Description                     |\n| -------- | ------ | ------------------------------- |\n| `status` | string | Set to `published` to make live |\n| `title`  | string | Override generated title        |\n\n---\n\n### Glue Tools\n\n**Health check:**\n\n```\nGET /api/agent/health\n```\n\n**Account info:**\n\n```\nGET /api/agent/me\n```\n\nReturns: `{ tenant_id, email, credits_remaining, plan }`\n\n### Product-Aware Generation\n\nUse product context to generate niche-specific lead magnets:\n\n**List products:**\n\n```\nGET /api/agent/products\n```\n\n**Search products:**\n\n```\nPOST /api/agent/products/search\nContent-Type: application/json\n\n{ \"query\": \"your search term\" }\n```\n\nPass product data into the `topic` or `niche` fields for highly targeted lead magnets aligned with your offerings.\n\n## Pricing\n\n| Type                       | Credits     | USD   |\n| -------------------------- | ----------- | ----- |\n| Text-only lead magnet      | 30 credits  | $0.30 |\n| Lead magnet with AI images | 100 credits | $1.00 |\n| Poll / status check        | 0 credits   | Free  |\n| Publish / update           | 0 credits   | Free  |\n\n1 credit = $0.01. Credits are deducted at generation time (Step 1). Polling and publishing are always free.\n\nPurchase credits at [https://www.citedy.com/dashboard/billing](https://www.citedy.com/dashboard/billing).\n\n## Rate Limits\n\n| Endpoint                     | Limit              |\n| ---------------------------- | ------------------ |\n| POST /api/agent/lead-magnets | 10 requests/hour   |\n| All other endpoints          | 60 requests/minute |\n\nIf you hit a rate limit, you receive HTTP 429. Wait before retrying.\n\n## Limitations\n\n- Maximum topic length: 500 characters\n- PDF generation takes 30-90 seconds depending on type and image generation\n- `auto_publish` skips human review — use only when you trust the generated content\n- Language support varies by niche; `en` has the highest quality\n- Images are AI-generated and may require review before publishing\n- One active generation per API key at a time (queue additional requests)\n\n## Error Handling\n\n| HTTP Code | Meaning                    | Action                                     |\n| --------- | -------------------------- | ------------------------------------------ |\n| 400       | Invalid parameters         | Check required fields and allowed values   |\n| 401       | Invalid or missing API key | Verify `CITEDY_API_KEY`                    |\n| 402       | Insufficient credits       | Top up at citedy.com/dashboard/billing     |\n| 429       | Rate limit exceeded        | Wait and retry                             |\n| 500       | Generation failed          | Retry once; if persistent, contact support |\n\nOn `status: \"failed\"` in poll response, retry the generation with the same parameters.\n\n## Response Guidelines\n\nWhen sharing a lead magnet with a user:\n\n1. Show the **title** and **type**\n2. Provide the **public_url** as the shareable link\n3. Mention that visitors enter their email to download\n4. Optionally show the **embed_code** for website integration\n5. Do NOT share the raw `pdf_url` directly — use the lead capture page to collect emails\n\nExample response to user:\n\n> Your lead magnet is ready: **\"The 27-Point SEO Audit Checklist\"**\n> Share this link to capture leads: https://www.citedy.com/leads/lm_abc123\n> Visitors enter their email to download the PDF.\n\n## Want More?\n\nCitedy offers a full suite of AI-powered content and SEO tools:\n\n- **SEO Agent** — Keyword research, competitor analysis, content gaps\n- **Blog Autopilot** — Automated blog content generation and publishing\n- **AI Insights** — LLM visibility checks and brand monitoring\n- **Social Adaptations** — Repurpose content for LinkedIn, Twitter, Instagram\n\nLearn more at [https://www.citedy.com](https://www.citedy.com)","tags":["citedy","lead","magnets","seo","agent","agent-skills","ai-agent","autogpt","content-marketing"],"capabilities":["skill","source-citedy","skill-citedy-lead-magnets","topic-agent-skills","topic-ai-agent","topic-autogpt","topic-content-marketing","topic-seo"],"categories":["citedy-seo-agent"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/citedy/citedy-seo-agent/citedy-lead-magnets","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add citedy/citedy-seo-agent","source_repo":"https://github.com/citedy/citedy-seo-agent","install_from":"skills.sh"}},"qualityScore":"0.456","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 12 github stars · SKILL.md body (9,932 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:07:17.975Z","embedding":null,"createdAt":"2026-04-23T13:04:22.769Z","updatedAt":"2026-05-18T19:07:17.975Z","lastSeenAt":"2026-05-18T19:07:17.975Z","tsv":"'-15':519 '-30':458 '-90':921 '/api/agent/health':235,771 '/api/agent/lead-magnets':264,438,493,547,590,680,737,890 '/api/agent/lead-magnets/':316,365 '/api/agent/me':247,775 '/api/agent/products':800 '/api/agent/products/search':804 '/dashboard/billing':1008 '/dashboard/billing](https://www.citedy.com/dashboard/billing).':884 '/dashboard/settings](https://www.citedy.com/dashboard/settings)':213 '/lead-magnets/lm_abc123-preview.png':358 '/lead-magnets/lm_abc123.pdf':353 '/leads/lm_abc123':391,1121 '0':687,747,854,859 '0.01':864 '0.30':842 '1':208,257,420,862,872,1048 '1.00':850 '10':518,891 '100':675,848 '2':214,309,471,1054 '20':457 '27':342,1108 '3':222,360,528,1063 '30':304,670,840,920 '4':398,1072 '400':981 '401':990 '402':1000 '429':907,1009 '45':307 '5':326,1081 '500':915,1016 '60':896 '90':549 'abc123':299,337,384 'account':243,772 'action':105,435,490,544,980 'activ':964 'adapt':1170 'addit':973 'agenc':433,444 'agent':221,434,489,543,1146 'ai':7,25,652,846,955,1139,1161 'ai-gener':651,954 'ai-pow':6,1138 'align':827 'allow':988 'alway':877 'analysi':1150 'api':205,217,225,240,252,269,322,371,587,967,994,998 'application/json':274,376,808 'ask':139,184 'asset':153,469 'audienc':405,542 'audit':278,345,422,428,441,1111 'author':237,249,266,319,368 'auto':292,564,657,929 'autom':1155 'automat':417 'autopilot':1154 'awar':785 'bearer':238,250,267,320,369 'blog':1153,1156 'bodi':275,377 'boolean':648,659 'brand':1167 'busi':281 'campaign':159 'capabl':93 'captur':71,152,416,468,731,1093,1117 'charact':916 'check':231,769,853,984,1165 'checklist':11,42,100,143,283,346,348,396,423,429,446,460,613,707,1112 'citedi':2,35,97,204,220,224,239,251,268,321,370,997,1132 'citedy-lead-magnet':1 'citedy.com':1007 'citedy.com/dashboard/billing':1006 'code':393,978,1077 'cold':475,483,495,521 'collect':516,1096 'compani':488 'competitor':28,1149 'contact':1023 'content':272,374,529,536,551,557,626,806,941,1141,1151,1157,1172 'content-typ':271,373,805 'context':789 'convert':17,48 'copi':120 'core':254 'creat':141,425,478 'credit':302,669,671,676,686,688,746,748,780,833,841,849,855,860,863,865,880,1002 'curat':113 'data':815 'day':550 'de':632 'deduct':867 'default':636,655,667 'depend':923 'descript':599,693,752 'diagram':574 'digit':285,448 'direct':713,1089 'download':146,394,411,715,1071,1127 'download.citedy.com':352,357 'download.citedy.com/lead-magnets/lm_abc123-preview.png':356 'download.citedy.com/lead-magnets/lm_abc123.pdf':351 'draft':330,339,662,700,719 'email':73,166,179,409,476,484,496,522,779,1069,1097,1125 'emb':392,1076 'en':288,451,510,560,630,637,947 'endpoint':887,895 'enter':407,1067,1123 'environ':229 'error':975 'es':633 'estim':305 'everi':325 'exampl':117,418,419,470,527,1098 'exceed':1012 'exclus':95 'fail':702,1018,1027 'fals':291,294,454,513,656,668 'field':596,691,692,750,821,986 'file':13,44,112,176,473,481,503,615,709 'follow':109 'format':526 'fr':634 'framework':15,46,121,187,531,538,553,555,571,617,710 'free':395,689,749,856,861,878 'freebi':171 'full':1135 'gap':1152 'generat':5,22,38,49,88,215,258,289,301,452,511,561,591,646,653,684,699,704,764,786,791,869,918,928,940,956,965,1017,1033,1158 'get':232,244,313,679,770,774,799 'glue':766 'go':209 'goal':129 'grow':75,164 'guid':144 'guidelin':1039 'handl':976 'header':236,248,265,318,367 'health':230,768 'high':63,823 'high-qual':62 'highest':950 'hit':900 'http':906,977 'human':932 'id':297,317,335,366,382,681,694,697,738,778 'illustr':26,654 'imag':290,453,512,562,647,678,725,847,927,952 'immedi':110,582,666 'includ':650 'info':773 'insight':1162 'instagram':1176 'instruct':40 'insuffici':1001 'integr':1080 'invalid':982,991 'item':106 'json':296,334,381,436,491,545 'key':206,218,226,241,253,270,323,372,968,995,999 'keyword':1147 'land':156 'languag':287,450,509,559,627,942 'lead':3,9,36,55,68,86,151,259,414,467,594,608,695,730,740,795,825,838,843,1043,1092,1103,1118 'learn':1177 'length':914 'limit':886,888,903,911,1011 'link':586,1062,1115 'linkedin':508,643,1174 'list':78,167,797 'live':760 'llm':1163 'lm':298,336,383 'magnet':4,10,37,56,69,87,260,595,609,696,741,796,826,839,844,1044,1104 'make':759 'market':286,432,443,449,558 'maximum':912 'may':958 'mcp':81 'mcp/skill':31 'mean':979 'mention':1064 'metadata':745 'methodolog':123,188,580 'minut':58 'miss':993 'monitor':1168 'need':149,173,202,534 'new':593 'nich':66,284,447,504,556,618,622,793,820,946 'niche-specif':65,792 'offer':85,830,1133 'one':963 'optim':644 'option':24,1073 'outreach':500 'overrid':763 'overview':41 'page':157,732,1094 'paramet':983,1037 'pass':813 'patch':362,736 'pdf':21,54,195,349,413,461,525,539,570,711,714,917,1087,1129 'per':966 'persist':1022 'plan':782 'platform':507,638 'point':343,459,1109 'poll':310,324,682,851,873,1029 'post':180,261,437,492,546,589,803,889 'power':8,33,94,1140 'prefix':219 'preview':354,722,724 'price':831 'process':126,194 'produc':61 'product':784,788,798,802,814 'product-awar':783 'proven':520 'provid':1055 'pt':631 'public':387,401,727,729,1057 'publish':53,293,361,379,386,565,581,658,665,701,721,735,742,757,857,875,930,962,1160 'purchas':879 'qualiti':64,951 'queri':809 'queue':972 'rate':885,902,1010 'raw':1086 'readi':51,118,312,333,462,1106 'ready-to-publish':50 'receiv':905 'refer':588 'regist':207 'remain':781 'repeat':125 'repurpos':1171 'request':974 'requests/hour':892 'requests/minute':897 'requir':598,959,985 'research':1148 'resourc':147 'respons':295,331,380,690,1030,1038,1099 'result':455,514,567 'retri':910,1015,1019,1031 'return':776 'review':933,960 'saa':487,499,505 'sale':506 'script':115,181 'search':801,811 'second':306,327,922 'seo':277,344,421,427,440,1110,1143,1145 'set':223,755 'setup':196 'share':399,400,1041,1084,1113 'shareabl':585,1061 'show':1049,1074 'skill':39,60,83,135,200 'skill-citedy-lead-magnets' 'skip':661,931 'small':280 'social':1169 'source-citedy' 'specif':67,625,794 'status':300,329,338,378,385,685,698,718,734,753,852,1026 'step':102,104,191,193,256,308,359,397,577,579,663,871 'step-by-step':101,190,576 'store':32,84 'strategi':530,537,552 'string':601,611,619,628,639,754,762 'structur':122,569 'subject':605 'subscrib':20,77 'suit':1136 'support':98,943,1024 'swipe':12,43,111,175,472,480,502,614,708 'take':919 'target':621,824 'templat':114,178,485,497,523 'tenant':777 'term':812 'text':673,836 'text-on':672,835 'time':870,971 'titl':340,703,705,761,765,1051 'tone':645 'tool':767,1144 'top':1003 'topic':276,439,494,548,600,603,818,913 'topic-agent-skills' 'topic-ai-agent' 'topic-autogpt' 'topic-content-marketing' 'topic-seo' 'true':563,566 'trust':938 'twitter':641,1175 'type':99,273,282,347,375,445,501,554,597,610,706,751,807,832,925,1053 'uniqu':92 'updat':739,744,858 'url':350,355,388,402,712,716,723,726,728,1058,1088 'usd':834 'use':132,133,198,303,464,787,934,1090 'user':138,161,183,424,477,532,1047,1101 'valu':989 'valuabl':170 'vari':944 'verifi':242,996 'visibl':1164 'visitor':18,72,107,406,1066,1122 'visual':573 'wait':908,1013 'want':162,1130 'websit':1079 'workflow':255 'www.citedy.com':212,234,246,263,315,364,390,883,1120,1180,1181 'www.citedy.com/api/agent/health':233 'www.citedy.com/api/agent/lead-magnets':262 'www.citedy.com/api/agent/lead-magnets/':314,363 'www.citedy.com/api/agent/me':245 'www.citedy.com/dashboard/billing](https://www.citedy.com/dashboard/billing).':882 'www.citedy.com/dashboard/settings](https://www.citedy.com/dashboard/settings)':211 'www.citedy.com/leads/lm_abc123':389,1119 'yes':602,612","prices":[{"id":"22e42f9b-9480-49c5-8cc0-4a409bad1373","listingId":"1cd10031-183d-49e0-aa05-859bd25bd651","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"citedy","category":"citedy-seo-agent","install_from":"skills.sh"},"createdAt":"2026-04-23T13:04:22.769Z"}],"sources":[{"listingId":"1cd10031-183d-49e0-aa05-859bd25bd651","source":"github","sourceId":"citedy/citedy-seo-agent/citedy-lead-magnets","sourceUrl":"https://github.com/citedy/citedy-seo-agent/tree/main/skills/citedy-lead-magnets","isPrimary":false,"firstSeenAt":"2026-04-23T13:04:22.769Z","lastSeenAt":"2026-05-18T19:07:17.975Z"}],"details":{"listingId":"1cd10031-183d-49e0-aa05-859bd25bd651","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"citedy","slug":"citedy-lead-magnets","github":{"repo":"citedy/citedy-seo-agent","stars":12,"topics":["agent-skills","ai-agent","autogpt","content-marketing","seo"],"license":"mit","html_url":"https://github.com/citedy/citedy-seo-agent","pushed_at":"2026-05-05T13:21:45Z","description":"AI-powered SEO content automation agent skill — trend scouting, competitor analysis, article generation in 55 languages, social media adaptations, and cron-based sessions.","skill_md_sha":"4b60a1f34fba66eff18f88fcb9fb4ec58d9e9009","skill_md_path":"skills/citedy-lead-magnets/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/citedy/citedy-seo-agent/tree/main/skills/citedy-lead-magnets"},"layout":"multi","source":"github","category":"citedy-seo-agent","frontmatter":{"name":"citedy-lead-magnets","description":"Generate 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."},"skills_sh_url":"https://skills.sh/citedy/citedy-seo-agent/citedy-lead-magnets"},"updatedAt":"2026-05-18T19:07:17.975Z"}}