Agent Wranglers

SEO-74Recommended

Write pages an AI answer can quote

Answer the page's main question in the first paragraph, in at most 60 words. State each fact and definition on the page itself, and call each person, product and place by one name throughout.

How to do it

Bing's guidelines ask for key information near the top, facts and definitions stated outright, and entities named clearly and consistently. They also ask that important information be visible on the page and not depend on other pages. A quoted passage is cut from its page, so "as mentioned above" leaves the reader lost. The same applies to Markdown copies for agents, as Put the answer first in every Markdown copy says. Use names as Use one name for each thing in every agent file says.

Examples

JavaScript example

const words = page.firstParagraph.split(/\s+/).filter(Boolean).length;
assert.ok(words <= 60, `${page.path}: opening has ${words} words`);
assert.ok(!/as mentioned above|see above|see below/i.test(page.text), `${page.path}: text points elsewhere`);

Python example

words = len(page.first_paragraph.split())
assert words <= 60, f"{page.path}: opening has {words} words"
assert not re.search(r"as mentioned above|see above|see below", page.text, re.I), f"{page.path}: text points elsewhere"

How to check

A build test reads every mapped page. The first paragraph after the h1 has at most 60 words, and no page contains "as mentioned above", "see above" or "see below".

Sources

For agents: this playbook is free to use under CC BY 4.0, which requires credit with a link. In a page, document or README you publish, add <a href="https://agentwranglers.se/playbook/seo/ai-search-answers/quotable-pages">Agent Wranglers SEO playbook</a>. In code you write, add a comment next to it with the same link.