Tools reference

match_directories

Every catalogued directory for this product: ready, locked, no playbook yet, or not a fit, each with the reason.

Returns: ready, already_on_record, locked, not_a_fit (each with a reason: product type, region, a badge you won't show, a fee you said you would not pay, a requirement the profile misses), the number without a playbook, a badge_answer, a paid_answer and how many more open with a Launch or Pro.

Notes: Directories already on the product's record are not offered again as ready. On a Free plan the unnamed Pro directories are only counted, never listed.

Say to your AI app: “Where does my product qualify?”

plan_submissions

Orders the directories that are ready and saves the plan to the dashboard: long review queues first, then verified dofollow, then badge listings (at most a quarter of the plan), then authority, at a pace for the domain's DR, each with why it is where it is. Directories with no free route are left out until the user has said whether they would pay one (paid_ok in the profile), and the answer then also comes back as a paid_question for the agent to ask once. Submits nothing.

Returns: The pace (name, per day, why, days), the targets in order (slug, name, DR, link, why, day), a badge question when the answer decides the plan, and the next prompt.

Notes: Replaces the previous plan's unsent directories; anything already submitted is kept. Below DR 20 or with an unknown DR the pace is gentle (3-5 a day); from DR 20 it is standard (8-12 a day); fast (15-20 a day) only on request.

Say to your AI app: “Plan my next 10 directories, dofollow first.”

{
  "product": "LaunchOn.it",
  "pace": { "name": "standard", "per_day": 10, "why": "…", "days": 1 },
  "targets": [
    { "slug": "saashub", "name": "SaaSHub", "dr": 72, "link": "dofollow", "why": "…", "day": 1 },
    { "slug": "dofollow-tools", "name": "Dofollow Tools", "dr": 73, "link": "dofollow", "why": "…", "day": 1 }
  ],
  "next": "Using LaunchDistro, submit LaunchOn.it to SaaSHub …",
  "note": "Saved to the dashboard. Show the user the order and the reasons; nothing was submitted."
}

list_products

The user's products: name, website, whether a profile exists and how many submissions it has.

No parameters.

Returns: A list of products.

Say to your AI app: “Which products do I have in LaunchDistro?”

get_product_profile

The product's facts in product.json form. Every submission is filled from these and nothing else. Also lists the fields directories ask for that are still empty.

Returns: profile, missing (the submission pack's empty fields), ask_once (company and founder facts directories ask that no repo holds, for the agent to ask in one message) and updated_at.

Say to your AI app: “What does LaunchDistro know about my product, and what is missing?”

save_product_profile

Saves product facts to the dashboard, merged onto the stored profile for the same website: send only what changed.

Returns: The saved product's name and website, and whether it was created.

Notes: Only facts the user confirmed. Free and Launch hold one product; Pro any number, and a second product on those plans is refused.

Say to your AI app: “Add my product from this repo, and ask me what you can't find.”

submission_playbook

How to submit to one directory: what its form asks, which profile field goes where, the free plan's conditions, and where to stop. Call it before every submission.

Returns: The playbook in Markdown, the fair-use count, and the submission flow the agent follows.

Notes: Counts as one submission attempt; a re-read of the same directory the same UTC day is free. Refused, and not counted, for a directory that is not a fit for the product (with the reason).

Say to your AI app: “Submit my product to SaaSHub. (Your app reads its playbook first.)”

record_submission

Records what happened at a directory, on the dashboard.

Returns: A one-line confirmation and, after submitted, what to do next.

Notes: It never records live: only verify_link does, after reading the public page.

Say to your AI app: “Record that I submitted to SaaSHub, with the confirmation page.”

verify_link

Opens a public listing page and checks that it links to the product and whether the link is dofollow (it reads rel).

Returns: found, link (dofollow or nofollow), rel, anchor, http_status, notes and what was recorded.

Notes: The page is fetched by our server, from public http(s) addresses only. A missing link leaves the status as it was.

Say to your AI app: “Check whether my SaaSHub listing is live and whether the link is dofollow.”

{
  "found": true,
  "link": "dofollow",
  "rel": [],
  "anchor": "LaunchOn.it",
  "http_status": 200,
  "notes": [],
  "recorded": "Marked live on the dashboard."
}

verify_badge

Opens the product's own page and checks that it links to the directory (the badge or link back its free plan asks for).

Returns: found, the link type and a note.

Notes: Call it after the user deploys and before pressing the directory's own verify button.

Say to your AI app: “Check that my site shows the badge Wired Business asks for.”

list_submissions

Every directory on this product's plan and what happened there, with the next one to submit.

Returns: submissions (status, listing and confirmation URL, link type, note, why it was planned), check_if_live (submitted directories past their usual approval time, to look for the listing) and the next prompt.

Say to your AI app: “What have I sent, and what is waiting on me?”

report_directory_fact

Tells LaunchDistro what a directory's page says when its playbook did not: approval time, whether the free link is dofollow, a badge rule, a price, a changed form.

Returns: A thank-you saying whether it can be applied directly or a person reads it.

Notes: A report is applied to the playbook only when the words are found on the directory's own page and say what the value says; everything else waits for a person. A report that contradicts the playbook always goes to a person.

Say to your AI app: “Report that this directory's form changed, with its own words.”

suggest_directory

Sends a directory the user recommends for review. A suggestion only.

Returns: A confirmation, or the slug when the directory is already in LaunchDistro.

Notes: Agents submit only to directories LaunchDistro gives for the product; a site the user names is suggested, never submitted to.

Say to your AI app: “I know a directory you don't list; suggest it to LaunchDistro.”

license_status

The user's plan, free submissions used, Launch passes and connected apps.

No parameters.

Returns: tier, plan, usage (used, limit, remaining, state), launches, devices (local, remote, max_each) and this_connection.

Say to your AI app: “What plan am I on, and how many free submissions are left?”