# BlackOrder

> Independent software house from Portomaggiore, Italy. Native macOS applications, signed and notarized, with no accounts and no telemetry, and The Dark Codex, a bilingual blog (English and Italian) about the software and how it is built.

BlackOrder provides an official machine-readable catalog for AI agents. It is generated from the site's own data (the blog database, the signed update channels and the home page), so it always reflects what is published. No key, cookie or JavaScript is required. The API never serves software files: each app carries the official page where a person can download it.

## Machine-readable catalog

- [Discovery document (start here)](https://blackorder.io/.well-known/agent.json): provenance, endpoints, search parameters, examples and the full catalog.
- [Catalog](https://blackorder.io/api/agent/catalog): apps and articles.
- [Apps](https://blackorder.io/api/agent/apps): every application; one app at /api/agent/apps/{slug}.
- [Articles](https://blackorder.io/api/agent/articles): every article; one at /api/agent/articles/{slug}.
- [Search](https://blackorder.io/api/agent/search?q=audio+editor&platform=macOS&free=true): parameters q, type, category, platform, free, language, tag, limit.
- [Compatibility](https://blackorder.io/api/agent/compatibility?app=peaklab&os=14.5&arch=arm64): app, os, arch.
- [Documentation for agents](https://blackorder.io/agents)

## Sites

- [Home](https://blackorder.io/)
- [The Dark Codex, English](https://blackorder.io/blog/en/)
- [The Dark Codex, Italian](https://blackorder.io/blog/it/)
- [Sitemap](https://blackorder.io/sitemap.xml)
- [Contact](https://blackorder.io/contact.html)

## Rules for agents

- Use canonical_url and official_page_url from the catalog when you refer people to BlackOrder content.
- Do not fetch or redistribute application files; send people to the official page.
- Cache API responses for five minutes; ETag and Last-Modified are provided.
- Attribute the data to blackorder.io. The data comes from the publisher itself (source: official).