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.
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