Why not write one long SEO prompt in plain text?

A structured JSON prompt is easier to reuse, review, and standardize across a team.

Which common fields matter most for SEO?

Task, audience, content length, output format, and language usually have the biggest impact.

Guides

How to build a JSON prompt for an SEO article

A practical walkthrough showing how to turn a plain SEO request into a structured JSON prompt with intent, structure, E-E-A-T, and output rules.

Published: April 2, 2026Updated: April 2, 2026Reading time: 6 minAuthor: Astraport Team

A good SEO prompt should do more than name the topic. It needs to define the search intent, the desired structure, the expected depth, and the output format.

1. Start with the plain-language request

Write the task the same way a marketer would explain it to an editor. Then move the exact request into the task field.

2. Add common controls

Target audience
Content language
Content length
Output format

3. Add SEO-specific settings

Search intent and page type
Heading structure and keyword logic
E-E-A-T signals
Internal links and CTA style

4. Review the final JSON

The prompt should be specific enough that another person can reuse it without guessing hidden assumptions.

json

{
  "task": "Create an SEO article about choosing a CRM for a small business",
  "target_audience": "Owners of small companies evaluating CRM options",
  "language": "en",
  "content_length": "1500_words",
  "output_format": "markdown",
  "search_intent": "commercial_investigation",
  "eeat_level": "expert",
  "heading_structure": "h1_h2_h3",
  "internal_links": "3_links",
  "cta_style": "soft_consultation"
}

Open the SEO builder