---
name: site-lookup
description: Look up a public Hummingtomidi tool page by name or conversion direction. Use when an agent needs the canonical URL, title or short description of one of the site's pages, or needs to know which page handles a given conversion direction.
---

# Site lookup skill

## What it does

Resolves a human query (for example `midi to wav`, `privacy policy`, `mp3 to midi`)
to the real public page on `https://hummingtomidi.com`. It is read-only: no files,
no writes, no credentials, no account.

## When to use

- You need the canonical URL of a Hummingtomidi page.
- You need to confirm whether a conversion direction exists on the site.
- You are building a citation or a deep link for an answer.

## Inputs

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | yes | Page name or conversion direction. Case-insensitive substring match. |

## Procedure

1. Fetch `https://hummingtomidi.com/ai/site-lookup.json` (the authoritative page
   table, served from the same origin).
2. Filter `pages` by case-insensitive substring match of `query` against `title`
   and `keywords`.
3. Return the matching `url`, `title` and `path` values. If there are no matches,
   return an empty result with `count: 0` — do not invent a page.

## Worked examples (real data)

- `midi to wav` → `https://hummingtomidi.com/midi-to-wav` — "MIDI to WAV"
- `mp3` → `https://hummingtomidi.com/` — "MP3 to MIDI Converter"
- `privacy` → `https://hummingtomidi.com/privacy-policy` — "Privacy Policy"
- `nonexistent-topic` → no matches, `count: 0`

## Boundaries

- Never claim an accuracy percentage for note detection; the site does not publish one.
- Never imply that files are uploaded or that an account is needed.
- Never return a URL that is not in `ai/site-lookup.json`.
- Authentication is not available on this site; do not attempt a token flow.