Add example draft

Author: bensenescu

README.md

@@ -3,7 +3,6 @@
 Sam is the best AI content writer. Sam is a minimal, customizable, and extendable agent that works with any model. Sam does keyword research, finds sources, and writes content that is actually good for your blog or website.
 
 Agents built on Claude Code all sound like Claude. OpenAI's GPT 5.4 is my preferred model for writing. GPT 5.4 actually changes its voice based on your preferences and doesn't have the tell-tale sentence structure of Claude. 
-
 ## Who is this for?
 - SEOs & Content Writers - Get more leverage by using the best available model to write drafts that you don't need to babysit or throw out.
 - Founders - Writing content from scratch is extremely tedious. If you're too early to pay a professional, Sam is the next best option for starting to rank for SEO terms relevant to your business.

example_draft.md

@@ -0,0 +1,355 @@
+NOTE: This is an example draft generated by Sam with zero edits and no config besides giving the website. There are definitely some things I would change, but I think its a pretty good start!
+
+
+**Meta Title**: Keyword Research for Beginners: How to Find the Right Terms
+**Meta Description**: Learn keyword research basics with a beginner-friendly framework to understand intent, choose relevant topics, and prioritize the terms worth targeting first.
+**Primary Keyword**: keyword research
+**Secondary Keywords**: keyword research basics, how to do keyword research, search intent, keyword prioritization, beginner keyword research
+**URL Slug**: keyword-research-for-beginners
+**Category**: SEO
+**Tags**: keyword research, SEO basics, search intent, content strategy, founder marketing
+
+# Keyword Research for Beginners: How to Find Terms Worth Targeting
+
+If you are new to keyword research, the hardest part is usually not finding keywords. It is knowing which ones matter.
+
+You can pull hundreds of terms from a tool in a few minutes. That does not mean you have a useful SEO plan. The real job is to understand what people are trying to do, which searches actually fit your business, and where to start.
+
+This guide is for technical SEOs and founders who want the basics explained clearly enough to act on them. By the end, you should be able to build a sensible keyword list, judge intent, and prioritize a few opportunities without pretending every high-volume term is worth chasing.
+
+## What keyword research actually is
+
+Keyword research is the process of finding the words and phrases people use in search, then deciding which of those searches are worth creating pages for.
+
+That sounds simple, but there are really three separate questions underneath it:
+
+1. **What are people searching for?**
+2. **Why are they searching for it?**
+3. **Should we try to rank for it?**
+
+Most beginners spend too much time on the first question and not enough on the other two.
+
+A keyword is not just a phrase in a spreadsheet. It is a signal about a real need. Someone wants to learn, compare, buy, fix, or validate something. If you understand that need, your content gets better. If you ignore it, your keyword list gets longer while your results stay flat.
+
+## Start with problems, not tools
+
+Before you open any SEO tool, write down what your audience is trying to get done.
+
+For a founder or technical SEO audience, that might include questions like:
+
+- How do I do keyword research without wasting time?
+- How do I know if a keyword is relevant to my product?
+- How do I compare competitors’ content strategy?
+- How do I find keywords for a new site with low authority?
+- How do I tell whether a term is informational or commercial?
+
+These are not polished target keywords yet. That is fine. They are starting points.
+
+A good beginner workflow is:
+
+- list your product or service categories
+- list customer problems
+- list the language real users use
+- list comparisons, alternatives, and job-to-be-done phrases
+- turn those into seed keywords
+
+For example, if you run an open source SEO platform, seed topics might include:
+
+- keyword research
+- competitor analysis
+- backlink analysis
+- SEO reporting
+- rank tracking
+- self-hosted SEO tools
+
+From there, you expand.
+
+The important point: tools help you scale research, but they should not be the source of your strategy.
+
+## Understand search intent before you choose keywords
+
+Search intent is the reason behind the query. If you get intent wrong, the page usually fails even if the keyword looks attractive.
+
+A practical beginner model is to group keywords into four buckets:
+
+### Informational intent
+
+The searcher wants to learn something.
+
+Examples:
+
+- keyword research basics
+- how to do keyword research
+- what is search intent
+
+These usually work best as guides, explainers, or tutorials.
+
+### Navigational intent
+
+The searcher wants a specific site, tool, or brand.
+
+Examples:
+
+- Google Search Console
+- Ahrefs keyword explorer
+- DataForSEO docs
+
+These are usually not great targets unless the search is for your own brand or a page you clearly own.
+
+### Commercial investigation intent
+
+The searcher is comparing options or evaluating solutions.
+
+Examples:
+
+- best keyword research tools
+- keyword research tools for startups
+- self-hosted SEO tools
+
+These often suit comparison pages, solution pages, or grounded list posts.
+
+### Transactional intent
+
+The searcher is ready to sign up, buy, download, or start.
+
+Examples:
+
+- keyword research software
+- SEO tool pricing
+- backlink checker free trial
+
+These terms can be valuable, but they usually need product or landing pages, not blog posts.
+
+### A simple way to check intent
+
+Search the term and look at the first page.
+
+Ask:
+
+- Are the top results guides, product pages, videos, or category pages?
+- Are people trying to learn, compare, or buy?
+- Would your planned page fit what already ranks?
+
+If the top results for a keyword are all beginner guides, a product page probably will not be the right format. If the results are mostly product and comparison pages, a broad educational blog post may struggle.
+
+Google’s guidance here is directionally useful: focus on helpful, people-first content rather than pages created mainly around keywords alone. See [Google Search’s helpful content guidance](https://developers.google.com/search/docs/fundamentals/creating-helpful-content).
+
+## Relevance matters more than raw traffic
+
+A keyword can be popular and still be wrong for you.
+
+Beginners often overvalue search volume because it feels objective. But a keyword only has real value if ranking for it helps the right audience discover something you can actually help with.
+
+A simple relevance test:
+
+- **Audience fit:** Is this search coming from the kind of person you want to reach?
+- **Problem fit:** Does the query connect to a problem your product, service, or content can solve?
+- **Page fit:** Can you create a page that deserves to rank for it?
+- **Business fit:** If this page succeeds, does it create a useful next step?
+
+For example:
+
+- **“keyword research”** is broad, educational, and highly relevant if you want to attract people early in the SEO learning process.
+- **“free movies online”** might have traffic, but it is irrelevant.
+- **“best seo tools”** might be relevant, but it is also broad and comparison-heavy, so it may be harder to win early.
+- **“keyword research for saas founders”** may have less traffic, but it is much closer to a specific audience and need.
+
+That tradeoff matters. A narrower keyword with stronger fit is often better than a broad term that attracts the wrong readers.
+
+## How to build a useful keyword list
+
+Once you have seed topics, expand them into clusters.
+
+A cluster is a main topic plus related subtopics, variations, and supporting questions.
+
+For the topic **keyword research**, your cluster might include:
+
+- keyword research basics
+- how to do keyword research
+- keyword research for beginners
+- how to find low competition keywords
+- how to prioritize keywords
+- keyword intent examples
+- keyword research for startups
+- keyword research for SaaS
+- keyword research mistakes
+
+This is where keyword tools can help. They can surface variations, related questions, and adjacent terms. If you are working in a setup that uses [DataForSEO](https://dataforseo.com/), you can pull keyword ideas through your own DataForSEO account instead of using a tool’s bundled data model. That said, the principle is the same no matter what tool you use: export ideas, then filter hard.
+
+When reviewing a list, keep these distinctions in mind:
+
+### Head terms vs long-tail keywords
+
+**Head terms** are broad and usually more competitive.
+
+Examples:
+
+- keyword research
+- SEO tools
+
+**Long-tail keywords** are more specific and often easier to match well.
+
+Examples:
+
+- keyword research for B2B SaaS
+- how to do keyword research for a new website
+
+Long-tail terms often make better early targets because they reveal clearer intent and let you write more focused pages.
+
+### Topic variants vs separate pages
+
+Not every keyword needs its own article.
+
+For example:
+
+- keyword research basics
+- beginner keyword research
+- keyword research for beginners
+
+These are probably the same search intent. One strong page can often cover them naturally.
+
+But these may deserve separate content:
+
+- keyword research
+- competitor keyword analysis
+- keyword prioritization framework
+
+The difference is intent and scope, not just phrasing.
+
+## How to prioritize keywords without overcomplicating it
+
+A beginner-friendly prioritization model is to score keywords across four factors:
+
+### 1. Relevance
+
+How closely does the keyword match your audience and offer?
+
+High relevance beats vague traffic.
+
+### 2. Intent quality
+
+Does the search imply real interest in the kind of help you provide?
+
+A query with clear educational or solution-seeking intent is often more useful than a fuzzy broad term.
+
+### 3. Difficulty or competition
+
+Can you realistically earn visibility?
+
+You do not need perfect scoring here. Just be honest. If the results are dominated by huge incumbents with deeply established pages, that may not be your best first move.
+
+### 4. Content opportunity
+
+Can you create something genuinely useful and better focused than what exists?
+
+Sometimes a keyword is worth targeting because the existing results are generic, outdated, or weak for your audience.
+
+### A simple example
+
+Imagine you are choosing between these three topics:
+
+| Keyword | Relevance | Intent clarity | Difficulty | Priority |
+|---|---|---:|---:|---:|
+| keyword research | High | High | High | Medium |
+| keyword research for beginners | High | High | Medium | High |
+| best SEO tools | Medium | Medium | High | Low |
+
+This is not a scientific model. It is a decision aid.
+
+For many newer sites, the best starting point is not the biggest keyword. It is the clearest keyword where you can publish the most useful page.
+
+## Common beginner mistakes in keyword research
+
+### Chasing volume without checking fit
+
+A keyword can look exciting and still bring the wrong audience.
+
+### Treating every variation as a separate opportunity
+
+If five terms mean the same thing, build one strong page instead of five thin ones.
+
+### Ignoring the current search results
+
+The current SERP is a practical clue to the type of content Google is rewarding for that query. Use that information.
+
+### Writing for the tool instead of the reader
+
+A page stuffed with phrases but weak on explanation, examples, or structure rarely performs well for long.
+
+### Picking keywords you cannot support with real expertise
+
+If you cannot explain the topic clearly or offer something useful, it probably should not be a priority yet.
+
+## A practical keyword research workflow you can use this week
+
+If you want a simple starting process, use this:
+
+### 1. Pick one audience and one core problem
+
+Example: founders who want to understand keyword research well enough to plan content.
+
+### 2. Write 5 to 10 seed phrases
+
+Include problem phrases, tool phrases, and outcome phrases.
+
+Example:
+
+- keyword research
+- how to do keyword research
+- keyword research for founders
+- SEO keyword prioritization
+- low competition keywords
+
+### 3. Expand the list with related terms and questions
+
+Use your preferred keyword source, search suggestions, People Also Ask, competitor pages, community language, and your own [Google Search Console performance data](https://support.google.com/webmasters/answer/7576553?hl=en) when you have it.
+
+### 4. Group terms by intent
+
+Separate learning queries from comparison queries and buying queries.
+
+### 5. Merge obvious duplicates
+
+Do not create separate pages for tiny wording changes with the same intent.
+
+### 6. Score each cluster
+
+Use relevance, intent, difficulty, and content opportunity.
+
+### 7. Choose one primary page and two or three follow-ups
+
+For example:
+
+- Primary: keyword research for beginners
+- Follow-up: how to prioritize keywords
+- Follow-up: keyword intent examples
+- Follow-up: competitor keyword analysis basics
+
+That gives you a small, coherent cluster instead of a random pile of ideas.
+
+## Where tools like OpenSEO fit
+
+Once you have the framework down, tools can help you collect ideas, inspect competitors, and organize terms into something usable.
+
+OpenSEO is one option if you prefer an open source and self-hosted setup. According to the [OpenSEO homepage](https://openseo.so), you can self-host it via Docker or Cloudflare, and it uses your own DataForSEO API key. That may suit teams that want more control over their tooling and usage-based costs. The tradeoffs are straightforward: you need DataForSEO credentials, the site notes that some features are still coming soon, and self-hosting is not the right setup for every team.
+
+The main point is the same either way: good keyword research starts with judgment, not software.
+
+## The goal is not more keywords. It is better decisions.
+
+Good keyword research helps you answer a simple question: what should we publish next, and why?
+
+If you can identify the searcher’s goal, judge whether the topic fits your audience, and prioritize a few realistic targets, you are already ahead of most beginner workflows.
+
+Start small:
+
+- pick one audience
+- choose one core topic
+- map intent
+- filter for relevance
+- publish one strong page
+
+That is enough to build momentum.
+
+You do not need a giant keyword database to begin. You need a clear view of the problems your audience is trying to solve and a practical way to decide which searches deserve your attention.
+