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.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
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.
API keys (prefixed citedy_agent_) authenticate against Citedy API endpoints only.
All traffic is TLS-encrypted.
Lead Magnet Generator — Skill Instructions
Overview
Checklists, swipe files and frameworks that convert.
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.
Supported types:
Checklist — Step-by-step action items visitors can follow immediately
Swipe File — Curated templates, scripts, and examples ready to copy
Framework — Structured methodology or repeatable process for a goal
When to Use
Use this skill when:
A user asks to create a checklist, guide, or downloadable resource
You need a lead capture asset for a landing page or campaign
A user wants to grow their email list with a valuable freebie
You need a swipe file of templates (emails, posts, scripts)
A user asks for a framework, methodology, or step-by-step process PDF
Instructions
Setup (run once)
If you don't have a saved API key for Citedy, run this flow:
1. Register
Preferred: run the included registration script:
node scripts/register.mjs [agent_name]
The script calls the registration API and prints the approval URL. If agent_name is omitted, it defaults to agent-<hostname>.
Alternative: call the API directly:
POST https://www.citedy.com/api/agent/register
Content-Type: application/json
{"agent_name": "<your_agent_name>"}
GET https://www.citedy.com/api/agent/lead-magnets/{id}
Headers: Authorization: Bearer $CITEDY_API_KEY
Poll every 5 seconds until status = "draft".
Response when ready:
{"id":"lm_abc123","status":"draft","title":"The 27-Point SEO Audit Checklist","type":"checklist","pdf_url":"https://download.citedy.com/lead-magnets/lm_abc123.pdf","preview_url":"https://download.citedy.com/lead-magnets/lm_abc123-preview.png"}
Share public_url with your audience. Visitors enter their email to download the PDF. Leads are captured automatically.
Examples
Example 1: SEO Audit Checklist
User: "Create an SEO audit checklist for my marketing agency"
Agent action:
POST /api/agent/lead-magnets
{"topic":"SEO audit for marketing agencies","type":"checklist","niche":"digital marketing","language":"en","generate_images":false}
Result: A 20-30 point checklist PDF, ready to use as a lead capture asset.
Example 2: Swipe File for Cold Emails
User: "Create a swipe file with cold email templates for SaaS companies"
Agent action:
POST /api/agent/lead-magnets
{"topic":"Cold email templates for SaaS outreach","type":"swipe_file","niche":"SaaS sales","platform":"linkedin","language":"en","generate_images":false}
Result: A collection of 10-15 proven cold email templates in PDF format.
Example 3: Content Strategy Framework
User: "I need a content strategy framework PDF for my audience"
Agent action:
POST /api/agent/lead-magnets
{"topic":"90-day content strategy framework","type":"framework","niche":"content marketing","language":"en","generate_images":true,"auto_publish":true}
Result: A structured PDF framework with visual diagrams and step-by-step methodology. Published immediately with a shareable link.
API Reference
POST /api/agent/lead-magnets
Generate a new lead magnet.
Field
Type
Required
Description
topic
string
Yes
Topic or subject of the lead magnet
type
string
Yes
checklist, swipe_file, or framework
niche
string
No
Target niche for more specific content
language
string
No
en, pt, de, es, fr, it (default: en)
platform
string
No
twitter or linkedin — optimizes tone
generate_images
boolean
No
Include AI-generated illustrations (default: false)
auto_publish
boolean
No
Skip draft step and publish immediately (default: false)
Credits: 30 credits text-only, 100 credits with images
GET /api/agent/lead-magnets/{id}
Poll for generation status.
Credits: 0 credits (free)
Response fields:
Field
Description
id
Lead magnet ID
status
generating, draft, published, failed
title
Generated title
type
checklist / swipe_file / framework
pdf_url
Direct PDF download URL (when status = draft or published)
preview_url
Preview image URL
public_url
Public lead capture page (when status = published)
PATCH /api/agent/lead-magnets/{id}
Update lead magnet (publish or update metadata).
Credits: 0 credits (free)
Field
Type
Description
status
string
Set to published to make live
title
string
Override generated title
Glue Tools
Health check:
GET /api/agent/health
Account info:
GET /api/agent/me
Returns: { tenant_id, email, credits_remaining, plan }
Product-Aware Generation
Use product context to generate niche-specific lead magnets:
List products:
GET /api/agent/products
Search products:
POST /api/agent/products/search
Content-Type: application/json
{ "query": "your search term" }
Pass product data into the topic or niche fields for highly targeted lead magnets aligned with your offerings.
Pricing
Type
Credits
USD
Text-only lead magnet
30 credits
$0.30
Lead magnet with AI images
100 credits
$1.00
Poll / status check
0 credits
Free
Publish / update
0 credits
Free
1 credit = $0.01. Credits are deducted at generation time (Step 1). Polling and publishing are always free.
If you hit a rate limit, you receive HTTP 429. Wait before retrying.
Limitations
Maximum topic length: 500 characters
PDF generation takes 30-90 seconds depending on type and image generation
auto_publish skips human review — use only when you trust the generated content
Language support varies by niche; en has the highest quality
Images are AI-generated and may require review before publishing
One active generation per API key at a time (queue additional requests)
Error Handling
HTTP Code
Meaning
Action
400
Invalid parameters
Check required fields and allowed values
401
Invalid or missing API key
Verify CITEDY_API_KEY
402
Insufficient credits
Top up at citedy.com/dashboard/billing
429
Rate limit exceeded
Wait and retry
500
Generation failed
Retry once; if persistent, contact support
On status: "failed" in poll response, retry the generation with the same parameters.
Response Guidelines
When sharing a lead magnet with a user:
Show the title and type
Provide the public_url as the shareable link
Mention that visitors enter their email to download
Optionally show the embed_code for website integration
Do NOT share the raw pdf_url directly — use the lead capture page to collect emails
Example response to user:
Your lead magnet is ready: "The 27-Point SEO Audit Checklist"
Share this link to capture leads: https://www.citedy.com/leads/lm_abc123
Visitors enter their email to download the PDF.
Want More?
Citedy offers a full suite of AI-powered content and SEO tools:
SEO Agent — Keyword research, competitor analysis, content gaps
Blog Autopilot — Automated blog content generation and publishing
AI Insights — LLM visibility checks and brand monitoring
Social Adaptations — Repurpose content for LinkedIn, Twitter, Instagram
