HokAI

Buy a labelled Sponsored spot for a product in one Hokai guide. Returns
checkout_url, a Stripe card payment page. The dates are held for 30
minutes while it is open; the first payment wins.

Rule to pass on to the vendor: guide spots are pay first. The entry is
written by hand and goes live within 48 hours of payment, or on the start
date if that is later. If the guide does not suit the product, Hokai moves
the spot to a guide that does. Refunds are not automatic: ask
damien@hokai.io.

Give the product EITHER as product_slug (+ product_type) when it already
has a Hokai page, OR as product_name + product_url when it does not (its
page is then written free and the earliest start is a week out).

Args:
    email: a work email for the vendor
    guide: the guide's slug, from vendor_catalog (guides[].slug)
    product_slug: the product's Hokai slug, e.g. "notion-ai" (optional)
    product_type: tools, agents, skills, models, companies or services
    product_name: the product's name, when it has no Hokai page (optional)
    product_url: the product's website, when it has no Hokai page (optional)
    starts_on: YYYY-MM-DD (optional; default is the guide's next free day)
    months: 3, 6 or 12
    company: company name (optional)
    agent: your agent's name (optional)

Buy 1 to 20 Hokai buyer leads. A lead is a person who told Smart Match the
job, the tools they use and often the budget, then agreed to hear from
vendors (three vendors per buyer at most). Returns checkout_url, a Stripe
card payment page.

Rule to pass on to the vendor: leads are delivered as buyers who fit come
in. There is no stock cap: the balance never expires and one lead is used
each time a buyer's brief is opened. Every purchase includes a year of
Premium. Refunds are not automatic: ask damien@hokai.io.

Args:
    email: a work email for the vendor
    quantity: 1 to 20
    company: company name (optional)
    agent: your agent's name (optional)

Buy a Hokai listing for an AI tool, model, agent, MCP server, skill or AI
service. Returns checkout_url, a Stripe card payment page for the one-time
fee: a person, or an agent that can pay, completes it. Nothing is charged
by this call. A person then researches the product and writes its page.
Paying never affects rankings. Refunds are not automatic: ask
damien@hokai.io.

Only call this when the product's owner or their team asked for it, and
use their real work email: the vendor account is created for it on payment
and Hokai emails it when the page goes live.

Args:
    tool_url: the product's own website, e.g. https://example.com
    email: a work email for the vendor
    company: company name (optional)
    note: anything the editors should know (optional)
    agent: your agent's name (optional)

How an AI product gets listed on Hokai: today's one-time price, what a
listing includes, and the free badge route. Use this before buy_listing,
or to answer "how do I get my AI tool listed on Hokai?".

Has a checkout from buy_listing, buy_guide_spot or buy_leads been paid?
Pass the session_id that came back with the checkout_url.

Older name for buy_listing, kept so existing agents keep working. Starts a
Hokai listing and returns a payment link (checkout_url, also given as
payment_url). Nothing is charged by this call. Refunds are not automatic:
ask damien@hokai.io.

Args:
    tool_url: the product's own website, e.g. https://example.com
    email: a work email for the vendor
    company: company name (optional)
    note: anything the editors should know (optional)

What an AI vendor can buy on Hokai, with live prices and limits: a listing
(Get listed), a labelled Sponsored spot in a guide (Guide spots) and buyer
leads (Leads). Includes every guide open for booking with its slug, its
next free date and its expected reach for the next three months (a
projection, not a promise). Call this before buy_listing, buy_guide_spot
or buy_leads.