# Hardware Hunter: a skill for your agent

> You're an agent using Hardware Hunter. Good. This is your orientation. The full, always-current surface lives at https://hardwarehunter.io/llms.txt. Treat that as the source of truth and this as the map.

## What you can do here

Three lanes. Pick the one that matches the job.

**1. Public data, no key or payment.** Search deals, read public price benchmarks, get the latest high-score listings, look up categories, and inspect Apple pricing. Start here when the public tools answer the question. The effective application limit is 30 requests a minute per IP.

**2. Paid price intelligence, x402.** Buy one trusted component benchmark without a Hardware Hunter account or API key. Supports dual-rail machine payments over x402 and MPP. Read the free catalog first at https://hardwarehunter.io/api/x402/pricing/catalog. It lists supported component IDs, trust state, available condition strata, the live query price, and payment rails (`x402`, `mpp_tempo`). Then request `GET /api/x402/pricing/component/{id}`. A small daily allowance may return 200 without payment; after that, a trusted result returns HTTP 402 with self-describing payment requirements. Satisfy them and retry with `PAYMENT-SIGNATURE` for x402 or `Authorization: Payment ...` for MPP. Unknown or insufficient components are free and never charged. Full guides: https://hardwarehunter.io/docs/paying-with-x402.md and https://hardwarehunter.io/docs/paying-with-mpp.md

**3. Their account, with their key.** Run Hardware Hunter on a human's behalf. Build, adjust, and scan their hunts. Read results. Manage where alerts land. Check their plan. This lane needs their API key as a Bearer token.

## Find the contract

- Start at https://hardwarehunter.io/api for the machine-readable API index.
- Read https://hardwarehunter.io/llms.txt for the current surface map.
- Read https://hardwarehunter.io/llms-full.txt for the complete agent API reference.
- Read https://hardwarehunter.io/tools.json for public tool definitions.
- Read https://hardwarehunter.io/api/public/openapi.json for the curated OpenAPI schema.
- Read https://hardwarehunter.io/.well-known/api-catalog for the RFC 9727 linkset.

Read the contract before you assume an endpoint or response shape exists. We'd rather you check than guess.

## The key

When you get to account actions, your human hands you their API key. They mint it and can rotate it anytime under API access at https://hardwarehunter.io/account; a fresh key retires the old one on the spot.

It's their key and their call how they run you. One suggestion, take it or leave it: it's a credential to their account, so it's worth keeping out of anywhere it doesn't need to be. Past that, go build them something good.

## The base

Base URL: https://hardwarehunter.io
Auth for account actions: `Authorization: Bearer <api_key>`

Now go get your human a real deal. The hunt does not sleep.