<!-- The markdown copy of https://oppalerts.com/docs/content-types/how-to-articles . All pages: https://oppalerts.com/docs/llms.txt -->

[Documentation](https://oppalerts.com/docs/) / [Content Types](https://oppalerts.com/docs/content-types/) / How to Find How-To Guides and Tutorials

# How to Find How-To Guides and Tutorials

See which tasks a market teaches, and which publishers teach them best.

Tags: [Content Marketing](https://oppalerts.com/docs/tag/content-marketing), [SEO](https://oppalerts.com/docs/tag/seo)

## What this type finds

The How-To Guides type finds pages that teach a reader to do something. It includes these kinds of pages:

- **Step-by-step tutorials.** A numbered list of actions that leads to one result.
- **Field guides and practical guides.** Longer pages that cover a whole task, with the reasons for each step.
- **Implementation guides.** Pages that show how to set up or roll out a product, a method, or a process.
- **Troubleshooting pages.** Pages that name a common problem and show how to fix it.
- **Tip pages for beginners and experts.** Short lists of advice for one task.
- **Instruction and safety pages.** Pages with operating steps, warnings, and rules for the safe use of something.

A content type describes the format of a page rather than its subject. The same subject can appear in many formats. The search keeps pages that match this format and are semantically similar to your market.

## Why it matters

How-to guides show you what a market teaches. When you enter an unfamiliar market, read guides from strong sites as well as new guides. You see the tasks that buyers need to do, the steps that are hard, and the order in which a field explains its work.

They also show you the experts. A person or a company that writes a clear guide for a hard task knows the task. Note the authors and the publishers. They are good sources for a quote, a review of your own guide, or a joint article.

Content types are for research. Use them when you take on a new client or enter an unfamiliar market. They show you what people in the market write and who writes it.

## Find it in the web app

1. Open **Content** in the web app menu.
2. Under **Content Types**, choose **How-To Guides**. The page searches as soon as it opens.
3. Open the **Prospect Index** tab. It shows indexed pages of this type, with the closest matches to your market first. **Min type score** starts at 40, and **Min similarity** starts at 30%.
4. Open the **News Index** tab to see what publishers are writing now. Set **Published** to a recent period. Most pages in the Prospect Index have no published date, so use **Added to index** there.
5. Raise **Min domain PR** if the list includes sites that nobody knows. Open **Details** on a row to see how to reach the site.

![The Content Types page with the How-To Guides type chosen, and the first rows of the Prospect Index tab.](https://oppalerts.com/img/docs/content-types/how-to-articles/content-types.png)

*The Content Types page with the How-To Guides type chosen.*

## See the new pages

The **Search for** menu of a saved opportunity in Edit Campaign lists the brand searches and the opportunity types. It does not include the content types. To follow new pages of this type, return to Content Types each week. Set **Added to index** to the last week on the Prospect Index tab, and set **Published** to the last week on the News Index tab. For the daily opportunities email for a campaign, read [Daily Monitoring and Alerts](https://oppalerts.com/docs/getting-started/daily-monitoring-and-alerts).

## In MCP and the API

Two tools search this type. One request body works for both:

```json
{
  "campaign": 3,
  "similarity_target": "campaign",
  "type_scores": [{"content_type": "how-to-articles", "type_score_min": 50}],
  "sort": "type_score"
}
```

- MCP: [`news_search`](https://oppalerts.com/docs/mcp/news_search) searches the News Index. [`prospects_search`](https://oppalerts.com/docs/mcp/prospects_search) searches the Prospect Index.
- API: [`POST https://api.oppalerts.com/v1/news/search`](https://oppalerts.com/docs/api/news_search) and [`POST https://api.oppalerts.com/v1/prospects/search`](https://oppalerts.com/docs/api/prospects_search), with the same JSON body.

In `type_scores`, `type_score_min` sets the minimum type score, from 1 to 100. Sorting by `type_score` puts the highest type score first. To keep only the newest pages, add `published_from` or `indexed_from`, with a date in YYYY-MM-DD format. The MCP pages list every parameter and include the full example response.

To connect your AI agent or to send API requests, read [Use OppAlerts in Your AI Agent](https://oppalerts.com/docs/getting-started/use-oppalerts-in-your-ai-agent), [Create an API Token](https://oppalerts.com/docs/getting-started/create-an-api-token), and [Your First API Call](https://oppalerts.com/docs/getting-started/your-first-api-call).

## How to judge the results

- **Check the date.** Steps for software and rules go out of date fast. An old guide can show a gap that you can fill with a current one.
- **Check that the steps work.** Read the guide as a beginner. A guide with missing steps is an opportunity to write a better one.
- **Check the author.** A named author with a track record in the field is a lead for an expert source.
- **Check the depth.** Compare a guide from a weak site and a guide from a strong site. The difference in depth and structure is the brief for your own guide.
- **Check the audience.** A guide for a beginner and a guide for a specialist answer different questions. Pick the one that fits your buyer.

[Browse all content types](https://oppalerts.com/docs/content-types/).

## Related Pages

- [How-To Guides](https://oppalerts.com/docs/app/content/types/how-to-articles) The How-To Guides content type finds pages of this type in the indexes.
- [`news_search`](https://oppalerts.com/docs/mcp/news_search) Searches the News Index by semantic similarity, words, dates, rank, outbound links, and type scores.
- [How to Find Content Ideas](https://oppalerts.com/docs/how-to/find-content-ideas) Turn customer questions and current coverage into content ideas that your business can support with evidence.
- [How to Research Customer Questions](https://oppalerts.com/docs/how-to/research-customer-questions) Find the questions that your customers ask and that are worth an answer.
- [Best Practices & Guides](https://oppalerts.com/docs/app/content/types/best-practices-and-guides) The Best Practices & Guides content type finds pages of this type in the indexes.
