add_sitemap_url: Agent-Managed Supplemental Sitemap

add_sitemap_url is the tool the Get AI Traffic agent uses to put a page into a supplemental XML sitemap after you approve a fix. It adds the URL you name to a list the plugin serves at /getaitraffic-sitemap.xml, then publishes the change through your site’s connection.

This page documents what the tool touches, what it refuses to touch, and how to undo it. For the decision of whether a page belongs in the sitemap, read No Sitemap Means You’ve Skipped XML Sitemap Best Practices and Sitemap Priority Won’t Fix a Missing Money Page. Those are the judgment calls. This page is about the mechanics.

What it does

When you approve a missing_sitemap or money_pages_sitemap action item, the agent adds the flagged URLs to a supplemental sitemap: a separate list, one URL per call, for pages your platform’s own sitemap leaves out. A money page that a plugin like Yoast excludes is the common case. The plugin serves that list at /getaitraffic-sitemap.xml, and you point crawlers at it by referencing the file in robots.txt with edit_robots_txt.

Each entry is a plain URL. The tool does not stamp a priority or changefreq on it, because Google ignores both values. Submitting a URL is a request to discover the page, not a command to index it. The engine still decides on its own whether the page is worth keeping.

What it will not touch

• Your existing sitemap. The tool maintains a supplemental list. It does not rewrite, replace, or reformat the sitemap your platform already generates; it fills the gaps that sitemap leaves.
• The page itself. Adding a URL says “this page exists and matters.” It changes nothing on the page, so a page that is noindexed or gated stays exactly as it was. That is why non-indexable URLs should be kept out: listing one just advertises a page the engine will refuse to index.
• Whether the page gets indexed. A sitemap entry is a discovery hint. It cannot force indexing, and the tool makes no such promise.

Timing

A crawler picks up the supplemental sitemap on its next visit, once robots.txt points to it. Discovery and indexing run on the engine’s schedule after that, not instantly. Adding the URL now pays off over the following crawls, not the same day.

Rolling back

Every applied change is written to the ledger with the prior membership. roll_back restores it exactly, dropping a URL you just added. remove_sitemap_url does the same thing as a deliberate action rather than an undo, and it refuses if the URL was never in the list.

Related tools

• remove_sitemap_url pulls a URL back out of the supplemental sitemap: the fix for a page that later goes noindex, gets gated, or turns into a duplicate. Keeping non-indexable URLs out is what keeps the discovery signal clean.
• edit_robots_txt adds the Sitemap: reference that tells crawlers the supplemental file exists. Without that pointer, the list is served but not advertised.
• purge_cache runs after an apply, so a cached copy of the old sitemap does not linger at the edge.

Findings this tool resolves

• missing_sitemap: nothing is submitting your pages to search engines for discovery.
• money_pages_sitemap: a conversion page is absent from the sitemap.