Skip to content

Documentation

Service Atlas

Research services, review provider evidence, and use the findings while writing.

Open Service Atlas

Service Atlas, the PirateSERP tool for industry research, builds a service list for an industry from real provider websites. For each service, it records the entities, attributes, verbs, and key phrases that the provider pages state, strictly from what those pages say. Before you start research, save an OpenRouter key and choose a model in Model for all AI tools in Account Settings. For the steps, see API keys.

The tiles at the top of the page count the shared research across all accounts: Industries mapped, Services mapped, Sites crawled, Entities identified, Verbs identified, and Key phrases.

Choose an industry

  1. In the Industry box, enter an industry, such as HVAC contractor. The list shows industries that PirateSERP users have already researched, so select a match to add to that research. If no listed industry fits, select Use "YOUR_TEXT" as custom industry to research it.
  2. In the Country list, select a country. The list starts with your default country and All Countries (worldwide), then English-speaking countries and All other countries.
  3. In the Language list, select a language. Your project's industry, country, and language fill the form when your project has them.
  4. Choose how to supply provider websites:
    • Click I'll paste company homepages to enter the provider homepages yourself.
    • Click Find companies for me to search for real providers in the selected country and language.

If the industry already has research in the selected language, Service Atlas opens that research immediately with a from cache label, and you can skip to Review services.

Supply provider websites

I'll paste company homepages opens Company homepages for "INDUSTRY" (one per line, up to 20). Enter one homepage per line, such as https://example.com.

Find companies for me lists Real Providers Found as cards with each site's title, address, and description. Every card starts selected. Clear the cards you don't want, or select or clear the Select all checkbox to change every card at once. If the search finds no providers, run the industry again with I'll paste company homepages.

A run accepts up to 20 company URLs. A counter reports how many URLs the run holds. When the list holds more than 20, the counter tells you how many URLs to remove. Click Research Selected to start, and follow the progress log. Click Cancel to stop a run.

Service Atlas keeps your pasted list separately for each industry, country, and language while your browser tab stays open. If a run fails, the list is still there when you return to it. After a successful run, Service Atlas clears the list, so Research More starts with an empty list.

Choose providers that offer the services you want to study. Leave out directories, marketplaces, and articles when you need a service list.

Review services

The Services list names each confirmed service and counts its items. Select a service to read its details:

  • Supporting entities: the entities that provider pages name with the service.
  • Entity attributes: the properties providers state about those entities.
  • Verbs: the actions providers describe.
  • Key phrases: multi-word terms the provider pages use about the service, such as "sediment buildup". Descriptive phrases such as "licensed and insured" appear under Entity attributes, and a single word is never a key phrase.

Items in lighter text came from an earlier research run; the rest come from the current run.

A service needs enough supporting research before it enters the confirmed list. If Service Atlas reports service candidates without enough supporting research, click Research More to add providers. Research from more providers confirms more services.

Research describes the selected providers. It does not establish that your business offers the same services. Keep your own business facts in your business profile.

Review relationships

Click Build Industry Ontology first. It builds the ontology for every service in the industry at once, and rebuilds any that already exist, so run it again after Research More adds evidence. Then click View Ontology on a service to open its ontology panel, and Hide Ontology to close it.

The ontology panel contains these sections:

  • What providers say lists the attributes and descriptions that provider sites state about the service, such as "licensed and insured" or an operating temperature. Each row shows how many sites state it, and the most-stated rows come first. Open a row to read each site's wording and domain. If a service has no What providers say section, click Research More to add research that includes it.
  • Stated relationships lists subject, relation, and object statements in the direction the sources stated them. Hold the pointer over a row to read its source sentence.
  • Related Entities lists entity pairs that appear together in the research, with Mentions together and Association. A strong association marks a topic to review; it does not establish a factual relationship.

If the panel says the service's ontology isn't built yet, click Build Industry Ontology. The tables group relationships into categories such as Taxonomic / Hierarchical, Mereological (Part-Whole), and Service actions, each with Subject, Relation, Object, and Evidence. Hold the pointer over an evidence label to read its source passage, and read that passage before you rely on the relationship.

Entity Relatedness ranks related entities with Graph, Similarity, Popularity, and Combined scores. Use it to find subjects worth checking in your content, not as a list of terms to add. Sparse source material can produce an empty result.

Explore the graph

Click Visualize Graph to open the industry in the Entity Graph Viewer, which shows its services, entities, and their connections as a graph. Select a node for its details and source links. For filtering and navigation, see the Entity Graph Viewer guide.

Check search refiners

The Search refiners card shows the words people add when they search for a business in this industry, such as "near me", "emergency", "cost", or "reviews". Click Show search refiners to load them. Each refiner shows its monthly searches.

English refiners are grouped by what the searcher wants:

  • Jobs and problems: the work and problems people hire for. Name these on your service pages.
  • Ways people want to act: availability and contact needs such as "near me" or "24 hour". Make these easy to act on.
  • Facts to state: details people look up, such as prices, hours, or licensing. Answer these on the page.
  • Sites people check: directories and review sites. Keep your listings on them complete and consistent.

Other searches collects shopping, career, and filler searches that don't come from someone hiring. For languages other than English, refiners are listed by search volume without groups.

Refiners come from real search data, so they can include brand and franchise names. Check a refiner against your own services before you act on it.

Continue or export research

Click Research More to add provider evidence to the industry. It reopens the source you chose on the form: an empty paste list for I'll paste company homepages, or another provider search for Find companies for me.

Click Export Text to download the research summary as a text file. The summary differs from the generated outline in Content Editor.

Use research in other tools

Open Content Editor and click Start from Industry Research to write from a researched industry. The research panel supplies terms, entities, verbs, and phrasing suggestions.

Select the researched industry in Entity SEO Auditor when you audit a related page.

Service Atlas industry research is shared across accounts and isn't private to you. Saved research is organized by language, so check Language when an industry appears to be missing. For language-specific limits, see Languages.

Only administrators see the Delete Industry, Delete Service, and item deletion controls. Removing shared research removes it for every account.