Skill

citedy-lead-magnets

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.

npx claudepluginhub citedy/claude-plugins --plugin citedy-seo-agent

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Checklists, swipe files and frameworks that convert.

Supporting Assets

README.md

SKILL.md

Similar Skills

lead-magnet

401

Designs lead magnets like checklists, templates, calculators, mini-courses, whitepapers for gated email capture and subscriber acquisition.

openclaudia-openclaudia-skills

lead-magnet

Creates high-converting lead magnets like checklists, templates, swipe files, mini-courses, and guides with landing page copy to generate email subscribers. Use for email lists, opt-ins, freebies, gated content.

1 file1 tool

majestic-marketing

memstack-marketing-lead-magnet

307

Creates lead magnets like checklists, templates, cheat sheets with landing page copy, delivery emails, nurture sequences for email list growth when users mention 'lead magnet' or 'opt-in'.

memstack

Stats

Stars10

Forks2

Last CommitMar 9, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

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

Setup

To use this skill, you need a Citedy API key.

Register:

Go to https://www.citedy.com/dashboard/settings
Generate an API key (prefixed citedy_agent_)
Set CITEDY_API_KEY in your environment

Health check:

GET https://www.citedy.com/api/agent/health
Headers: Authorization: Bearer $CITEDY_API_KEY

Verify account:

GET https://www.citedy.com/api/agent/me
Headers: Authorization: Bearer $CITEDY_API_KEY

Core Workflow

Step 1: Generate Lead Magnet

POST https://www.citedy.com/api/agent/lead-magnets
Headers:
  Authorization: Bearer $CITEDY_API_KEY
  Content-Type: application/json

Body:
{
  "topic": "SEO audit for small businesses",
  "type": "checklist",
  "niche": "digital marketing",
  "language": "en",
  "generate_images": false,
  "auto_publish": false
}

Response:

{
  "id": "lm_abc123",
  "status": "generating",
  "credits_used": 30,
  "estimated_seconds": 45
}

Step 2: Poll Until Ready

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"
}

Step 3: Publish

PATCH https://www.citedy.com/api/agent/lead-magnets/{id}
Headers:
  Authorization: Bearer $CITEDY_API_KEY
  Content-Type: application/json

Body:
{
  "status": "published"
}

Response:

{
  "id": "lm_abc123",
  "status": "published",
  "public_url": "https://www.citedy.com/leads/lm_abc123",
  "embed_code": "<a href='https://www.citedy.com/leads/lm_abc123'>Download Free Checklist</a>"
}

Step 4: Share

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.

Purchase credits at https://www.citedy.com/dashboard/billing.

Rate Limits

Endpoint	Limit
POST /api/agent/lead-magnets	10 requests/hour
All other endpoints	60 requests/minute

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

Learn more at https://www.citedy.com