From citedy-seo-agent
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-agentThis skill uses the workspace's default tool permissions.
Checklists, swipe files and frameworks that convert.
Designs lead magnets like checklists, templates, calculators, mini-courses, whitepapers for gated email capture and subscriber acquisition.
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.
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'.
Share bugs, ideas, or general feedback.
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:
Use this skill when:
To use this skill, you need a Citedy API key.
Register:
citedy_agent_)CITEDY_API_KEY in your environmentHealth 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
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
}
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"
}
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>"
}
Share public_url with your audience. Visitors enter their email to download the PDF. Leads are captured automatically.
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.
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.
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.
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
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) |
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 |
Health check:
GET /api/agent/health
Account info:
GET /api/agent/me
Returns: { tenant_id, email, credits_remaining, plan }
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.
| 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.
| 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.
auto_publish skips human review — use only when you trust the generated contenten has the highest quality| 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.
When sharing a lead magnet with a user:
pdf_url directly — use the lead capture page to collect emailsExample 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.
Citedy offers a full suite of AI-powered content and SEO tools:
Learn more at https://www.citedy.com