# MineralFYI

> Comprehensive mineral encyclopedia — minerals with physical properties, 7 crystal systems, Strunz classification, Mohs hardness, localities, countries, rock types, and mineral comparisons. Covers luster, streak, cleavage, fracture, transparency, specific gravity, and optical properties.

## Data Scope
- Minerals with chemical formulas, crystal systems, and Strunz classification
- Physical properties (Mohs hardness, specific gravity, color, luster, streak, cleavage, fracture)
- Optical properties and transparency data
- 7 crystal systems (cubic, hexagonal, trigonal, orthorhombic, tetragonal, monoclinic, triclinic)
- Strunz mineral classes (silicates, oxides, sulfides, etc.)
- Countries with mineral occurrence data
- Notable mineral localities with geographic coordinates
- Rock types (igneous, sedimentary, metamorphic) with constituent minerals
- Mineral comparisons (N² pages) with side-by-side property analysis
- External IDs: Mindat, IMA number, RRUFF, Wikidata
- Glossary terms organized by mineralogy category
- Guides in series with full markdown content
- 9 interactive tools: mineral identifier, hardness comparison, crystal system explorer, and more
- 15 languages supported with i18n

## URL Patterns
- Append `.md` to any URL for plain-text markdown format.
- i18n: URL prefix `/{lang}` for non-English (ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id).
- `/` — Homepage with featured minerals and stats (e.g. `/`)
- `/minerals/` — Browse all minerals (e.g. `/minerals/`)
- `/mineral/{slug}/` — Mineral detail page (e.g. `/mineral/quartz/`)
- `/classes/` — Browse Strunz mineral classes (e.g. `/classes/`)
- `/class/{slug}/` — Mineral class detail (e.g. `/class/silicates/`)
- `/crystal-systems/` — Browse 7 crystal systems (e.g. `/crystal-systems/`)
- `/crystal-system/{slug}/` — Crystal system detail (e.g. `/crystal-system/cubic/`)
- `/countries/` — Browse countries with minerals (e.g. `/countries/`)
- `/country/{code}/` — Country mineral page (e.g. `/country/br/`)
- `/localities/` — Notable mineral localities (e.g. `/localities/`)
- `/locality/{slug}/` — Locality detail (e.g. `/locality/tsumeb/`)
- `/rocks/` — Rock types (e.g. `/rocks/`)
- `/rock/{slug}/` — Rock type detail (e.g. `/rock/granite/`)
- `/compare/` — Mineral comparison index (e.g. `/compare/`)
- `/compare/{slug1}/vs/{slug2}/` — Mineral comparison (e.g. `/compare/quartz/vs/feldspar/`)
- `/glossary/` — Mineralogy glossary (e.g. `/glossary/`)
- `/glossary/{slug}/` — Glossary term (e.g. `/glossary/cleavage/`)
- `/guides/` — Mineral guides (e.g. `/guides/`)
- `/guide/{slug}/` — Guide article (e.g. `/guide/mineral-collecting-basics/`)
- `/tools/` — Interactive mineral tools (e.g. `/tools/`)
- `/tool/{slug}/` — Tool page (e.g. `/tool/mineral-identifier/`)
- `/mineral/{slug}/collecting/` — Collecting guide for a mineral (e.g. `/mineral/quartz/collecting/`)
- `/nearby/` — Mineral localities near any location (e.g. `/nearby/`)
- `/nearby/{slug}/` — Minerals near a specific locality (e.g. `/nearby/tsumeb/`)
- `/search/` — Search minerals, localities, rocks (e.g. `/search/?q=quartz`)

## Browse Minerals
- [All Minerals](https://mineralfyi.com/minerals/)
- [Strunz Classes](https://mineralfyi.com/classes/)
- [Crystal Systems (7)](https://mineralfyi.com/crystal-systems/)
- [Countries](https://mineralfyi.com/countries/)
- [Localities](https://mineralfyi.com/localities/)
- [Rock Types](https://mineralfyi.com/rocks/)
- [Mineral Comparisons](https://mineralfyi.com/compare/)

## Interactive Tools
- [Mineral Identifier](https://mineralfyi.com/tool/mineral-identifier/)
- [Hardness Comparison](https://mineralfyi.com/tool/hardness-comparison/)
- [Crystal System Explorer](https://mineralfyi.com/tool/crystal-system-explorer/)
- [Mineral Checklist](https://mineralfyi.com/tool/mineral-checklist/)
- [Streak Test Guide](https://mineralfyi.com/tool/streak-test-guide/)
- [Specific Gravity Calculator](https://mineralfyi.com/tool/specific-gravity-calculator/)
- [Mineral Value Estimator](https://mineralfyi.com/tool/mineral-value-estimator/)
- [UV Fluorescence Guide](https://mineralfyi.com/tool/fluorescence-guide/)
- [Chemical Formula Decoder](https://mineralfyi.com/tool/chemical-formula-decoder/)

## Location
- [Mineral Localities Near Me](https://mineralfyi.com/nearby/)

## Learn
- [Mineralogy Glossary](https://mineralfyi.com/glossary/)
- [Guides](https://mineralfyi.com/guides/)

## Embed Widget
- [MineralFYI Widget Docs](https://widget.mineralfyi.com)
- [mineralfyi-embed on npm](https://www.npmjs.com/package/mineralfyi-embed)
- [mineralfyi-embed on GitHub](https://github.com/fyipedia/mineralfyi-embed)

## REST API

Free REST API. No authentication required. JSON responses. CORS enabled.

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/api/v1/minerals/` | List minerals (DRF, paginated) |
| GET | `/api/v1/minerals/{slug}/` | Mineral detail |
| GET | `/api/v1/classes/` | Mineral classes (DRF, paginated) |
| GET | `/api/v1/crystal-systems/` | Crystal systems (DRF, paginated) |
| GET | `/api/v1/countries/` | Countries (DRF, paginated) |
| GET | `/api/v1/localities/` | Localities (DRF, paginated) |
| GET | `/api/v1/rocks/` | Rock types (DRF, paginated) |
| GET | `/api/v1/glossary/` | Glossary terms (DRF, paginated) |
| GET | `/api/v1/guides/` | Guides (DRF, paginated) |
| GET | `/api/v1/tools/` | Interactive tools (DRF, paginated) |
| GET | `/api/v1/faqs/` | FAQs (DRF, paginated) |
| GET | `/api/v1/search/?q={query}` | Unified search (DRF) |
| GET | `/api/v1/stats/` | Site statistics |
| GET | `/api/search/suggest/?q={query}` | Search autocomplete |

```bash
curl -s "https://mineralfyi.com/api/v1/minerals/"
```

[API Docs](https://mineralfyi.com/developers/) · [OpenAPI Spec](https://mineralfyi.com/api/openapi.json)

## Developer Tools
- **PyPI**: `pip install mineralfyi` — [mineralfyi](https://pypi.org/project/mineralfyi/) — Mineral data, crystal systems, Mohs hardness scale
- **Embed Widget**: [mineralfyi-embed](https://widget.mineralfyi.com)

## Science FYI Family

Part of [FYIPedia](https://fyipedia.com) developer tools ecosystem.
- [ChemFYI](https://chemfyi.com) — Periodic table, elements, compounds, reactions
- [AlloyFYI](https://alloyfyi.com) — Metal alloys, compositions, properties
- [GemFYI](https://gemfyi.com) — Gemstones, mineralogy, grading, origins
- [StarFYI](https://starfyi.com) — Stars, constellations, exoplanets, deep-sky objects

## Images (CDN)

OG images for all entities at https://cdn.mineralfyi.com/og/{type}/{slug}.png
- https://cdn.mineralfyi.com/og/homepage.png

## Full Index
- [Full content index](https://mineralfyi.com/llms-full.txt)
- [XML Sitemap](https://mineralfyi.com/sitemap.xml)