Dataset builders
TerraCotta is a bot operated by Ceramic AI that crawls pages into a dataset that may be reused or shared with third parties. TerraCotta is Ceramic's web crawler that indexes public content to power their web-scale search API for AI and LLMs. It is documented as honouring robots.txt, but no IP range list or reverse-DNS convention is published, so a request carrying this user agent cannot be proven genuine.
Request says
"TerraCotta"
Checked against
Nothing published
Live check
No operator check exists for TerraCotta. This still shows what the address really is.
Reference
| User agent | TerraCottaToken only: match on the substring. |
|---|---|
| Operator | Ceramic AI |
| Purpose | Dataset builders |
| Respects robots.txt | Honourssource |
| Verification method | Claim onlyNone published, user agent only No IP range file and no reverse-DNS convention have been published for this agent. The user-agent string is the only signal, and any client can send it, so treat a match as a claim rather than proof. |
| Crawl pattern | Not published |
| Robots.txt tokens | TerraCottaTerra Cotta |
| Operator documentation | None published |
TerraCotta is Ceramic's web crawler that indexes public content to power their web-scale search API for AI and LLMs.
robots.txt
Paste one at the root of your domain. Rules are per token.
User-agent: TerraCotta
User-agent: Terra Cotta
Disallow: /User-agent: TerraCotta
User-agent: Terra Cotta
Allow: /User-agent: TerraCotta
User-agent: Terra Cotta
Allow: /
Disallow: /account/
Disallow: /checkout/
Disallow: /searchEdit the Disallow paths to match your own URLs.
Blocking TerraCotta keeps your pages out of the datasets it builds from future crawls. It does not remove anything collected earlier, and how each operator uses or shares its data varies, so check their policy.
Build a file for every crawlerFAQ
TerraCotta is a bot operated by Ceramic AI that crawls pages into a dataset that may be reused or shared with third parties. TerraCotta is Ceramic's web crawler that indexes public content to power their web-scale search API for AI and LLMs. It is documented as honouring robots.txt, but no IP range list or reverse-DNS convention is published, so a request carrying this user agent cannot be proven genuine.
Yes. The operator documents that TerraCotta reads robots.txt and follows Disallow rules for its own token. Rules take effect on the next fetch of the file, which can be hours or days after you publish them.
You cannot, at least not from the request itself. No IP range file and no reverse-DNS convention have been published for this agent. The user-agent string is the only signal, and any client can send it, so treat a match as a claim rather than proof. Compare the source IP against hosting and datacenter ranges instead, and rate limit anything that behaves like a crawler.
Add these user-agent tokens (TerraCotta, Terra Cotta) to robots.txt with Disallow: /. If the crawler ignores robots.txt, match the user agent at your CDN or reverse proxy and return 403 there instead.
Blocking TerraCotta keeps your pages out of the datasets it builds from future crawls. It does not remove anything collected earlier, and how each operator uses or shares its data varies, so check their policy.