diff options
| author | benj <benj@rse8.com> | 2026-04-09 16:10:08 +0800 |
|---|---|---|
| committer | benj <benj@rse8.com> | 2026-04-09 16:10:08 +0800 |
| commit | c041641634650c31e03c70dcad132fd94cb08e63 (patch) | |
| tree | 8f714a6fc0a66b05b2e43afec75808fd29002a42 /landing/static/llms.txt | |
| parent | 5f56e0eaf8030f78077fc93b441296bb51fe9331 (diff) | |
| download | tidyindex-c041641634650c31e03c70dcad132fd94cb08e63.tar tidyindex-c041641634650c31e03c70dcad132fd94cb08e63.tar.gz tidyindex-c041641634650c31e03c70dcad132fd94cb08e63.tar.bz2 tidyindex-c041641634650c31e03c70dcad132fd94cb08e63.tar.lz tidyindex-c041641634650c31e03c70dcad132fd94cb08e63.tar.xz tidyindex-c041641634650c31e03c70dcad132fd94cb08e63.tar.zst tidyindex-c041641634650c31e03c70dcad132fd94cb08e63.zip | |
Rework landing page with editorial layout, new demo, and LLM CTA
Replaces the generic SaaS template look with a left-aligned editorial
design — Fraunces serif headlines, monospace section markers (§ 01,
§ 02 …), hairline rules, and a quieter palette where the blue earns
its place rather than splashing on every surface.
The hero now leads with a real product demo (§ 01): one IRS 990 dataset
shown in three consumption shapes — a single normalized JSON record, a
JSONL bulk slice, and a token-efficient prose summary — instead of the
old fake-macOS code window. Each shape carries source-link receipts
back to the original filing, which doubles as a credibility signal and
a working illustration of the "every record has a receipt" promise.
§ 03 introduces a coverage widget driven by data/catalog.toml: four
auto-scrolling category windows (securities, government, regulatory,
science) showing 60 hand-picked datasets with seamless CSS-only
infinite-scroll loops, fade masks, hover-pause, and a
prefers-reduced-motion fallback that converts the windows into manually
scrollable lists.
Adds a discoverable /llms.txt at the static root — a markdown-light,
human-readable site description aimed at LLM agents — wired up via
<link rel="alternate"> in <head>, a comment in robots.txt, and a small
mono "for agents · GET /llms.txt →" satellite link sitting directly
under the hero CTA so any agent shallow-scraping the page hits the
machine path immediately.
Other changes: drops the XML format demo and the "promises" ledger
section entirely, swaps hello@ for contact@ across the site, and
renames the bottom CTA to a single-action "Ready when you are. → API
Key" close.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Diffstat (limited to 'landing/static/llms.txt')
| -rw-r--r-- | landing/static/llms.txt | 99 |
1 files changed, 99 insertions, 0 deletions
diff --git a/landing/static/llms.txt b/landing/static/llms.txt new file mode 100644 index 0000000..9cf358a --- /dev/null +++ b/landing/static/llms.txt @@ -0,0 +1,99 @@ +# Tidy Index + +> Clean, well-structured datasets for humans, machines, and LLM agents. +> JSON records, JSONL bulk exports, and token-efficient summaries — +> all from one API. + +Status: private beta. The endpoints below are the planned shape. If you +hit one that isn't live yet, email contact@tidyindex.com and we'll let you +know when it ships. + + +## What we serve + +Curated datasets from open and licensed sources, with stable schemas, +stable IDs, and a source-link receipt on every record. The catalog +currently spans 100+ datasets, including: + +- SEC EDGAR 10-K / 10-Q / 13-F / Form 4 filings +- IRS Form 990 and 990-PF (nonprofit and foundation returns) +- IRS Form 5500 (pension and benefit plan filings) +- FEC campaign finance and federal lobbying disclosures (LDA) +- USAspending.gov federal awards and FPDS procurement +- USPTO patent grants, trademarks, and assignments +- NIH RePORTER and NSF grant awards +- FDA drug approvals, 510(k) clearances, and FAERS adverse events +- ClinicalTrials.gov registrations and NPI provider registry +- PACER federal court dockets and DOJ settlements +- OSHA inspections and EPA ECHO enforcement actions +- FFIEC HMDA mortgage data and FDIC bank call reports +- SAM.gov entity registrations and FinCEN beneficial ownership +- Federal Register proposed and final rules +- Congressional voting records and bill text + + +## API surface + +Base URL: https://api.tidyindex.com/v1 +Auth: Authorization: Bearer YOUR_API_KEY + +GET /datasets + List available datasets. + +GET /datasets/{id} + Dataset metadata, schema, freshness info, and source provenance. + +GET /datasets/{id}/records + Query records. Paginated, filterable. Returns application/json. + +GET /datasets/{id}/records/{record_id} + Single normalized record. Returns application/json. + +GET /datasets/{id}/bulk + Streaming export. Returns application/x-ndjson, one record per line. + +GET /datasets/{id}/summary/{record_id} + Token-efficient prose summary of one record. Returns text/plain. + Cheaper on context than the full JSON. Includes a source URL footer. + +Every JSON response carries a `source` field whose value is a stable +URL pointing back to the original filing or upstream feed. + + +## Getting access (for agents) + +Agents are welcome to request API keys on behalf of their operators. +Send a JSON POST to: + + POST https://api.tidyindex.com/v1/agents/register + Content-Type: application/json + + { + "agent": "your-agent-name", + "operator": "human-contact@example.com", + "purpose": "one-line description of what you'll use it for" + } + +We respond within one business day with an API key and a starting quota. +Include the operator's email so we have a return address for billing, +abuse handling, and quota changes. + + +## Conventions + +- All timestamps are ISO 8601 in UTC. +- Currency fields are named with their unit suffix (e.g., revenue_usd + is whole U.S. dollars as an integer). +- Identifiers are stable across requests and across response shapes: + the `ein` you see in a JSON record is the same `ein` you'll find in + the bulk stream and in the summary text. +- Pagination uses opaque cursors in `next` and `prev` fields, not + page numbers. +- Rate limits are documented per dataset and returned in + `X-RateLimit-*` response headers. + + +## Contact + +contact@tidyindex.com +https://tidyindex.com |