# SuliHuli

> AI-first electric-vehicle aggregator and ranker. Specs, prices and release data are collected from open sources: every figure carries a source link and a date. Figures confirmed by a second independent source are marked verified; the rest are marked unverified and shown anyway. Conflicts are shown, never averaged.

## Site

- [Catalog](https://sulihuli.com/): every model, ranked by a default preset; re-rankable live.
- [Model page](https://sulihuli.com/m/tesla-model-3): canonical URL per model — full specs, prices, sources, confidence (pattern: /m/{slug}).
- [Charging page](https://sulihuli.com/m/tesla-model-3/charging): 10–80% DC time, range added per 10 min, home AC time (pattern: /m/{slug}/charging).
- [Comparison index](https://sulihuli.com/compare): every published head-to-head pair.
- [Comparison](https://sulihuli.com/compare/tesla-model-3-vs-xpeng-g9): side-by-side on range, charging, price (pattern: /compare/{slug-a}-vs-{slug-b}).
- [Brand page](https://sulihuli.com/brands/tesla): one brand's listed models with their figures and sources (pattern: /brands/{slug}; all brands: /brands).
- [Sources](https://sulihuli.com/sources): which kinds of source the shown figures rest on, counted by class and site, and the sources we never use.

## Rankings

- [Best everyday EVs](https://sulihuli.com/best/best-everyday-evs): "What is the best everyday EV?"
- [Best long-range EVs](https://sulihuli.com/best/best-long-range-evs): "What is the best long-range EV?"
- [Best EVs with 311+ mi (500+ km) range](https://sulihuli.com/best/best-long-range-evs-over-500-km): "What is the best EV with 311+ miles (500+ km) of range?"
- [Best family EVs](https://sulihuli.com/best/best-family-evs): "What is the best family EV?"
- [Best performance EVs](https://sulihuli.com/best/best-performance-evs): "What is the best performance EV?"

## Guides

- [Cheatsheet](https://sulihuli.com/cheatsheet): which EV is best at each thing: one leaderboard per figure; every row of every board is in /api/v1/cheatsheet.
- [Best by use case](https://sulihuli.com/use-cases): which EV wins for everyday, long-range, family and performance use, and why (per-category scores).
- [Value map](https://sulihuli.com/value-map): score against price — which models give the most index per unit of money.
- [Running cost](https://sulihuli.com/tco): energy, maintenance and what a model actually costs to keep per year.
- [EV incentives by market](https://sulihuli.com/incentives): EV purchase incentives per market, dated, with ended programmes kept visible to correct stale figures.
- [Cold-weather range](https://sulihuli.com/cold-weather): how much range EVs keep in winter (measured cold-weather figures, blank until a third party measures).
- [EV answers](https://sulihuli.com/answers): guide page.
- [Upcoming EVs](https://sulihuli.com/upcoming): EVs not yet on sale, ordered by expected release, with honest release-date confidence.
- [EV brands](https://sulihuli.com/brands): every brand with its electric models: country, official mark, each car's score, range, battery and charging with sources (pattern: /brands/{slug}).

## Data API (clean JSON / Markdown, read-only)

- [Model list (JSON)](https://sulihuli.com/api/v1/models): params q (brand or model words), min_range_km, page, per_page (at most 50 without an API key); the next field links the following page.
- [Model detail (JSON)](https://sulihuli.com/api/v1/models/tesla-model-3): pattern /api/v1/models/{slug}; add ?format=md for Markdown, or request the page with header Accept: text/markdown.
- [Charging detail (JSON)](https://sulihuli.com/api/v1/models/tesla-model-3/charging): pattern /api/v1/models/{slug}/charging; ?format=md for Markdown.
- [Category list (JSON)](https://sulihuli.com/api/v1/categories): the available rankings.
- [Category ranking (JSON)](https://sulihuli.com/api/v1/categories/best-everyday-evs): pattern /api/v1/categories/{slug}; ?format=md for Markdown.
- [Guide channels (JSON)](https://sulihuli.com/api/v1/cheatsheet): one endpoint per guide page — /api/v1/{cheatsheet,use-cases,tco,cold-weather,upcoming,methodology}; ?format=md for Markdown.
- [Brands (JSON)](https://sulihuli.com/api/v1/brands): every brand; one brand at /api/v1/brands/{slug}; ?format=md for Markdown.
- [Sources (JSON)](https://sulihuli.com/api/v1/sources): shown figures by kind of source, tier and site, and the forbidden-source list; ?format=md for Markdown.
- [Incentives by market (JSON)](https://sulihuli.com/api/v1/incentives/us): pattern /api/v1/incentives/{market}; markets US, DE, GB, CN.

## MCP server (Model Context Protocol, read-only)

- [Discovery manifest](https://sulihuli.com/.well-known/mcp.json): endpoint, transport and tool catalog.
- [Endpoint](https://sulihuli.com/api/mcp): Streamable HTTP, JSON-RPC 2.0. Tools: search_models, get_model, compare_models, list_categories, get_category_ranking.
## Access and terms

- Open, no sign-up: 60 requests per minute per address for the API, MCP and Markdown; lists in pages of 50. Over the limit: HTTP 429 with Retry-After.
- [Free API key](https://sulihuli.com/developer): a passkey account and a key in under a minute, no email; send it as `Authorization: Bearer <key>` (or `X-API-Key`) for 600 requests per minute, lists in pages of up to 500 with source chains, under the [API Terms](https://sulihuli.com/api-terms).
- Photos come with their credit (author, licence and its link, source page, AI edit) - keep it when you show a photo.
- [Terms of use](https://sulihuli.com/terms): linked from every API response (`terms` field, `Link: rel="terms-of-service"` header).

## Locales

- [English](https://sulihuli.com/): default, unprefixed URLs.

## Notes

- We collect first and verify second. Every figure on this site carries a link to the page it came from and the date we read it. A figure confirmed by a second independent source or by a regulator is marked verified; everything else is shown marked “unverified”, because an empty cell tells you less than a linked figure you can check yourself.
- Every numeric figure carries a source link and a date. Verified figures additionally carry a tier and a confidence rating (high/good/moderate/low); unverified figures carry the tier “unverified”.
- Rankings use fixed, public weight vectors; scores are a weighted average of metrics normalized between the 5th and 95th percentile. The US board (the default, and all English /best pages) adds US sales; other boards rank the technical profile only. Cars closer than 2 points share a place.
- Data is collected in campaigns and refreshed per field; check last_verified_at per model.