# Firecrawl SEO audit Human Guide

## What This Is For
Use this to turn a website into a specific, prioritized SEO audit. It gives the agent a clearer input/output frame for search and SEO workflows: what context to ask for, what decisions to make, and what usable artifact to return.

Use this as a human-readable version of the Firecrawl SEO audit agent skill. It is meant for marketers, operators, founders, and other non-coders who want the workflow without reading agent-specific implementation instructions.

## When To Use This
- Use this when you need a repeatable process for firecrawl SEO audit.
- Use this when the task needs judgment, examples, constraints, or a clear output format rather than a one-off prompt.
- Use this when you want to hand an AI assistant enough context to produce a usable marketing artifact.

## When Not To Use This
- Do not use this when you only need a quick factual answer.
- Do not use this when the work depends on private data you cannot share with the assistant.
- Do not use this as a replacement for legal, compliance, financial, or medical review.

## What You Need Before Starting
- The goal or business outcome you want.
- The audience, customer segment, or market context.
- Any source material the assistant should respect, such as notes, briefs, examples, URLs, or brand guidance.
- Constraints such as tone, length, channel, deadline, region, or approval requirements.
- A clear definition of what a good final answer should look like.

## Step-By-Step Workflow
1. State the job clearly: "Use the Firecrawl SEO audit guide to help me with..."
2. Add context: audience, goal, offer, channel, source material, and constraints.
3. Ask the assistant to identify missing inputs before producing the final output.
4. Have the assistant follow the skill-specific guidance below.
5. Review the result against the final checklist and ask for revisions where needed.

## Skill-Specific Guidance
- Map the site with Firecrawl to understand URL structure.
- Scrape key pages: homepage, product/service pages, pricing, docs, blog, about, and high-value landing pages.
- Extract title tags, meta descriptions, headings, internal links, content structure, canonical signals when visible, and image alt text when available.
- Search target keywords when provided; scrape top ranking pages for comparison.
- Site Structure: URL patterns, sitemap health, internal linking, orphan/broken pages.
- On-Page SEO: titles, meta descriptions, H1/H2 hierarchy, content quality.
- Keyword And SERP: target keywords, ranking pages, competitor page patterns.
- Technical Issues: broken links, duplicate content signals, missing metadata.
- Make recommendations specific, not generic.
- Show the page or source behind each issue.
- Distinguish technical findings from content strategy guesses.

## Decision Points And Nuance
The original skill emphasizes: Onboarding Interview, Firecrawl Collection Plan, Parallel Work, Final Deliverable, Executive Summary, Site Structure, On-Page SEO, Keyword Opportunities, Competitor/SERP Comparison, Prioritized Recommendations.

Use these questions to steer the work:
- What is the intended audience or buyer?
- What source material must be preserved?
- What should the assistant optimize for: clarity, persuasion, accuracy, speed, creativity, or conversion?
- What examples represent the desired quality bar?
- What should the assistant avoid?

## Common Mistakes
- Ask at most 1-3 concise questions only if blocked, such as the site URL, required target keywords, or whether a specific page/competitor set matters.

## Copy-And-Paste Prompt
```text
Use the Firecrawl SEO audit human guide.

My goal:
[Describe the business outcome]

Audience:
[Describe who this is for]

Context and source material:
[Paste notes, examples, links, or existing copy]

Constraints:
[Tone, length, channel, timeline, must-include items, must-avoid items]

Before producing the final output, ask me for any missing information that would materially improve the result.
```

## Final Checklist
- [ ] The output matches the original goal.
- [ ] The audience and context are reflected in the answer.
- [ ] Important constraints and source material were preserved.
- [ ] The assistant made the relevant decisions explicit.
- [ ] The final artifact is ready to use, review, or hand to the next person.

## Source
This guide was generated from the firecrawl/firecrawl-workflows skill entry for `firecrawl-seo-audit`.

## Source Skill Notes
These notes preserve the nuance from the original skill. Use them as supporting reference when the workflow above feels too generic.

# Firecrawl SEO Audit

Use this to turn a website into a specific, prioritized SEO audit.

## Onboarding Interview

Infer the site, target keywords, and output format from context. If the site is clear, proceed immediately.

Ask at most 1-3 concise questions only if blocked, such as the site URL, required target keywords, or whether a specific page/competitor set matters.

## Firecrawl Collection Plan

1. Map the site with Firecrawl to understand URL structure.
2. Scrape key pages: homepage, product/service pages, pricing, docs, blog, about, and high-value landing pages.
3. Extract title tags, meta descriptions, headings, internal links, content structure, canonical signals when visible, and image alt text when available.
4. Search target keywords when provided; scrape top ranking pages for comparison.

## Parallel Work

If appropriate, use sub-agents or equivalent parallel task runners:

- Site Structure: URL patterns, sitemap health, internal linking, orphan/broken pages.
- On-Page SEO: titles, meta descriptions, H1/H2 hierarchy, content quality.
- Keyword And SERP: target keywords, ranking pages, competitor page patterns.
- Technical Issues: broken links, duplicate content signals, missing metadata.

## Final Deliverable

```markdown
# SEO Audit: [Site]

## Executive Summary
[Top risks and opportunities]

## Site Structure
[Pages found, URL quality, sitemap/internal-link notes]

## On-Page SEO
[Per-page title, meta, headings, content, linking notes]

## Keyword Opportunities
[Target keywords, missing pages, content gaps]

## Competitor/SERP Comparison
[Who outranks the site and why]

## Prioritized Recommendations
[High/medium/low impact fixes with exact changes]

## Sources
[URLs scraped and what was checked]

## Rerun Inputs
workflow: firecrawl-seo-audit
site: [url]
keywords: [list]
output: [markdown/json]
```

## Quality Bar

- Make recommendations specific, not generic.
- Show the page or source behind each issue.
- Distinguish technical findings from content strategy guesses.
