Docs / For AI agents

Prompting tips

How to describe TableArchive to an AI assistant so it writes working code first time.

Give it the facts

Start your request with a paragraph like this, or point the assistant at llms.txt:

Things assistants get wrong

  • Players is exact. players=2 means playable with two, not "two or more". Say so if your app means something else.
  • Editions are hidden by default. A plain search returns games, not printings. Ask for kind=edition or search by barcode to get them.
  • Photo links expire. Have the code fetch the item again rather than store thumb_url.
  • Keys stay server-side. Ask for a small proxy or serverless function if the app runs in a browser.
  • Rate limits. Ask for a wait on 429 using Retry-After.

A prompt that works

Coming later

An MCP server, so agents can call search and lookup as tools without writing HTTP code.