Run an AI prompt on your pages with your own AI key

One question about each page

In Site Pages you select pages, write one instruction and run it. The AI answers it once for every page. The answers sit in a column next to the pages, and you can download them.

Typical jobs are a new title for a page whose title is too long, a meta description for a page that has none, or a one-line check that a page's title and H1 agree. PerfBee never applies an answer to your site. You read it, and you decide.

Add your key and run a prompt

1. Make an API key with OpenAI, Anthropic or Google Gemini, in a provider account that has credit. The provider charges for every request.
2. In PerfBee open Settings, then Integrations. In AI provider keys paste the key, press Save key, and press Test. Only the workspace owner and admins can do this.
3. Open Site Crawler, then Site Pages, and stay in the Pages view. Tick the pages you want and press Run AI prompt. A run takes up to 1,000 pages.
4. Pick a prompt, or write a new one: a name, the provider and model, your instruction and the page fields to send. Press Start from a template for a first version.
5. Press Check before running. You see how many pages will be sent and to whom. Nothing leaves PerfBee until you confirm.

Then open AI column in the filter row and choose the prompt. AI answers downloads them as CSV or Excel. A workspace keeps up to 10 prompts and 50,000 stored answers. More steps are in the help article.

What the model sees, and what it does not

The model sees your instruction and, for each page, the fields you ticked. They are the ones Site Pages stores from your scans: the address, title, meta description, H1, word count, canonical URL, meta robots and HTTP status. Site Pages also stores the declared language, first H2, social title and description, a summary of the structured data and the main text of the page. The menu and footer are left out of the text, and a longer text is cut at 50,000 characters. The default is the address, title, description and H1.

It does not see:

• the images or the links of a page;
• any other page, or your site as a whole;
• numbers that come from Google. They are never sent to a model, by design;
• anything about your PerfBee account.

PerfBee tells the model that the page data is text to read, not instructions, because a page's author wrote it. An answer is plain text of at most 6,000 characters and does nothing by itself. Code you ask for, HTML or JSON-LD, comes in a box of its own after PerfBee removes scripts, styles, event handlers and links to other sites from it.

What it does well, and what it does not

The model reads the stored fields you tick, the main text of the page included. It is best at reading one page and drafting a fix.

• Rewrite titles and descriptions that are too long, too short, missing or repeated.
• Check that a page's title, H1 and description tell the same story.
• Make duplicate titles different from each other.
• Label each page by type and by what a visitor wants.
• Say which question a page answers, and whether its first lines answer it.
• Draft an FAQ from the text of a page, or list the dates and years in it.
• Check the text of a page against your brand voice.
• Write JSON-LD for a page, or its FAQ as HTML, to paste into the page once you have read it.
• Spot titles that mix languages.
• Turn a page that answers with an error, or a canonical and meta robots conflict, into a short note for a developer.

It reads one page at a time, so it cannot compare two pages. It does not see images, links or search data, so it cannot write image alt text, suggest internal links or explain why a page does badly in search. Every answer is a draft. Check its length and its meaning before you use it.

We ran these prompts on our own pages, and every answer is in AI prompts for SEO, with the answers.

Three prompts to start with

Each prompt asks for a fixed answer format. Tick the address, title, meta description and H1 for all three. The templates Fix titles, Write meta descriptions, Check title, H1, description and Developer note for a problem page start from the same idea.

Check the title of this page against its H1 and meta description.
Answer in exactly this format:
Verdict: OK or FIX
Reason: one short sentence
New title: a title of 50 to 60 characters that says what the page is about, or KEEP if the title is fine
If the title is missing, write Verdict: FIX and write a new title from the H1.
Use the language of the page. Do not use quotation marks.

Write a meta description for this page from its title and H1.
Answer with the description only, in plain text, 120 to 155 characters, in the language of the title.
Do not repeat the title word for word and do not promise anything the page data does not show.
If the page already has a description of that length that fits the title, answer KEEP.
If there is no title and no H1, answer NOT ENOUGH DATA.

Check whether the title, the H1 and the meta description are about the same topic.
Answer in exactly this format:
Match: YES, PARTLY or NO
Difference: one short sentence naming what differs, or NONE
Fix: one short sentence saying which of the three to change, or NONE

Models count characters loosely, so check the length of a new title or description yourself.

Ask one question about one page

Page Detail has an Ask AI tab. Type a question about that page, up to 4,000 characters, and pick a provider you have a key for. The model reads the stored fields of the page and its main text. An answer can be up to 10,000 characters.

When no text is stored, or you tick Read the live page, PerfBee reads the page once as PerfBeeBot and respects robots.txt. PerfBee deletes the question and the text it read once the answer is written, and the answer ten minutes after you ask, so copy it if you want to keep it. None of them goes into its database.

Ask for code, such as JSON-LD for the page or a section in HTML, and it shows under the answer with Copy code. Links stay only when they point to your own site. Read the code before you paste it into your site.

Cost and privacy

Your provider charges your account for each request, at the price of the model you chose. PerfBee adds no charge and uses no credits. It shows how many pages and about how many input tokens will be sent, never an amount of money. Try five or ten pages first.

PerfBee sends the instruction and the ticked fields to the provider you chose, with your key, only when you run a prompt or ask a question in Page Detail. The provider handles them under your own agreement with it. PerfBee stores the key encrypted and each answer with its page. It deletes an answer with its prompt, its site or your account, and when its page leaves Site Pages.