SEO Article Generator with Website Context

Generate SEO-ready article drafts from a topic or YouTube URL using customer website context, search intent, metadata, FAQs, and internal-link suggestions.

This is not a generic AI article writer. It uses a multi-step SEO content workflow built from practical e-commerce SEO work, where organic search is one of the most heavily invested growth channels. The workflow uses website context, target page context, source material, article structure, metadata, FAQ ideas, and internal-link opportunities before returning a review-ready draft.

This Actor calls the Uygar Content API at /api/v1/generate, waits for the server-sent event result, and writes one structured dataset item with the article draft and SEO metadata. Add the customer's website, target page, reference articles, brand notes, audience details, or product context to make the draft fit the business behind the article.

Who it is for

Use this Actor when you need a strong first draft for a blog, service page, category-support article, or content brief and want the SEO structure handled before an editor reviews the piece. It is built for agencies, consultants, SaaS teams, e-commerce operators, local service businesses, and teams that publish SEO content regularly.

This is not an automatic publishing pipeline and it does not guarantee rankings. It produces a structured draft with SEO fields, source context, FAQ ideas, and internal-link suggestions so a human editor can publish faster with better inputs.

What it does

• Turns a topic, keyword, title idea, or YouTube URL into a markdown SEO article draft.
• Uses supplied company website, target page, reference articles, brand context, audience notes, and product details when you provide them.
• Adds focus keyword, SEO keywords, meta description, FAQ, sources, and internal-link suggestions when returned by the backend.
• Can generate an optional featured image.
• Keeps raw model output out of the public dataset, while returning a usage summary with model breakdown, tokens, calls, and estimated cost.

Use cases

• Draft blog posts for AI automation, SaaS, consulting, local service, and B2B websites.
• Turn YouTube tutorials or product videos into article drafts.
• Create Swedish or English article drafts with brand context.
• Produce a first draft with SEO metadata that an editor can review before publishing.

What you get

Each successful run returns one article package:

• markdown article draft
• title, excerpt, focus keyword, SEO keywords, and meta description
• FAQ suggestions and source references when available
• internal-link suggestions for site owners
• optional featured image URL
• SEO score returned by the backend
• usage summary with model breakdown, input/output tokens, LLM calls, and estimated cost

Input

• sourceType: topic_research for a topic idea or youtube_video for a YouTube URL.
• sourceInput: article topic, keyword, title idea, or YouTube URL.
• companyWebsite: the customer's public website for brand and offer context.
• articleDestinationUrl: where the article will be published, or the page/category it should support.
• referenceUrls: optional public customer pages or existing articles, one URL per line.
• language: en or sv.
• tone: professional, conversational, or technical.
• targetWordCount: target article length from 600 to 1600 words.
• generateImage: generate a featured image when enabled.
• findYoutube: include related YouTube tutorials when available.
• niche and clientContext: optional brand, audience, product, public-page summary, and editorial instructions.

Advanced/private inputs:

• apiKey: optional customer-scoped Uygar Content API key override. Leave it blank on public Store runs.

Example inputs

Topic to article:

{
  "sourceType": "topic_research",
  "sourceInput": "AI automation for small business support teams",
  "companyWebsite": "https://example.com",
  "articleDestinationUrl": "https://example.com/blog/ai-automation-support",
  "referenceUrls": "https://example.com/services\nhttps://example.com/blog/customer-support-guide",
  "niche": "AI automation consulting",
  "tone": "professional",
  "targetWordCount": 600,
  "language": "en",
  "generateImage": false,
  "findYoutube": false,
  "clientContext": "Write for founders and operations managers. The company sells practical AI automation workshops and wants direct, non-hype content."
}

YouTube video to article:

{
  "sourceType": "youtube_video",
  "sourceInput": "https://www.youtube.com/watch?v=VIDEO_ID",
  "tone": "technical",
  "targetWordCount": 1000,
  "language": "en",
  "generateImage": true
}

Output

The default dataset contains one item with:

• request ID and status
• title, excerpt, focus keyword, SEO keywords, meta description
• markdown article content
• SEO score when returned by the backend
• image URL when generated
• internal links, FAQ, sources, claim checks, YouTube tutorials, URL QA warnings
• usage summary with model breakdown, tokens, LLM calls, and estimated cost

Limits and review

This Actor creates drafts, not legal, medical, financial, or compliance advice. Review facts, claims, and citations before publishing. Image generation and YouTube enrichment can add runtime and cost. YouTube conversion requires a public transcript or captions; videos without a usable transcript fail with a clear transcript error.