TofuBofu AI Visibility

Fetch the results of an AI-visibility scan started with scan_ai_visibility.

Args:
    report_id: The id returned by scan_ai_visibility.

Returns:
    While running: {status: "running", progress}. When done: the Tofu Index
    (named in the consideration set) and the Bofu Index (picked head to
    head), each with its fraction, the Tofu Index per engine, share of
    voice, sentiment, the top competitors winning the answers, any gap
    between the competitors the user named and the ones AI names, and
    top_fixes, the open items at the top of the brand's Fixes list (the same
    list the app's Fixes page shows; empty when there is none), plus the
    report_url.

Step one of a scan: read the company's website and return the scan form's steps, pre-filled with what we read. Call this first, walk the user through steps in order, show them the answers and the queries, and get a yes before calling scan_ai_visibility. Every value is a guess from the website (or, for a signed-in workspace's returning brand, what the brand already holds) for the user to confirm or correct. Returns brand_name, steps (each with title and fields: param, question, help, kind, options, value, suggestions), scan (engines, queries_per_engine, queries_total) and how_to_ask.

Start an AI-visibility scan of a company's website. It asks ChatGPT, Claude, Perplexity, Gemini, Google AI Mode real buying queries and records which companies they name. A free scan asks 5 queries on each engine, 25 in all. A call carrying a TofuBofu API key (Authorization: Bearer tb_live_...) re-scans that workspace's existing brand for the website, on its plan and quota.

Before calling: call research_company, walk the user through its steps, show them the pre-filled answers and the queries (for a returning brand, the ones its last scan asked, which this scan asks again), and get a yes. Ask where they sell if you do not know it: geo_scope changes every query. Omit a field you do not know rather than inventing a value.

The scan runs in the background (a few minutes); call get_visibility_report with the returned report_id. Returns report_id, report_url, assumed (answers not supplied) and query_warnings (buyer_questions that read as a topic, each with its reason; every one is still asked as sent). status "not_started" with report_id null means no scan ran: the email already has an account, or this website's free scan already ran this month. A sign-in link went to that inbox; show the note and stop.