Metadata-Version: 2.4
Name: nihonshufyi
Version: 0.1.0
Summary: Sake knowledge API client — search sake grades, breweries, and terms from NihonshuFYI.
Project-URL: Homepage, https://nihonshufyi.com
Project-URL: Documentation, https://nihonshufyi.com/developers/
Project-URL: Repository, https://github.com/fyipedia/nihonshufyi
Project-URL: Issues, https://github.com/fyipedia/nihonshufyi/issues
Project-URL: Changelog, https://github.com/fyipedia/nihonshufyi/releases
Author: FYIPedia
License-Expression: MIT
License-File: LICENSE
Keywords: brewery,daiginjo,japanese-rice-wine,junmai,koji,nihonshu,prefecture,rice,sake,umami
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.10
Provides-Extra: all
Requires-Dist: httpx>=0.27; extra == 'all'
Requires-Dist: mcp>=1.0; extra == 'all'
Requires-Dist: rich>=13.0; extra == 'all'
Requires-Dist: typer>=0.15; extra == 'all'
Provides-Extra: api
Requires-Dist: httpx>=0.27; extra == 'api'
Provides-Extra: cli
Requires-Dist: rich>=13.0; extra == 'cli'
Requires-Dist: typer>=0.15; extra == 'cli'
Provides-Extra: mcp
Requires-Dist: mcp>=1.0; extra == 'mcp'
Description-Content-Type: text/markdown

# nihonshufyi

Sake knowledge API client for developers — search sake grades, breweries, and terminology from [NihonshuFYI](https://nihonshufyi.com).

## Install

```bash
pip install nihonshufyi[api]     # API client (httpx)
pip install nihonshufyi[cli]     # + CLI (typer, rich)
pip install nihonshufyi[mcp]     # + MCP server
pip install nihonshufyi[all]     # Everything
```

## Quick Start

```python
from nihonshufyi.api import NihonshuFYI

with NihonshuFYI() as api:
    results = api.search("junmai daiginjo")
    print(results)
```

## CLI

```bash
nihonshufyi search "junmai daiginjo"
nihonshufyi search "niigata"
nihonshufyi search "yamada nishiki"
```

## MCP Server

```bash
# Add to Claude Desktop config
python -m nihonshufyi.mcp_server
```

Tools: `sake_search`

## API Client

```python
from nihonshufyi.api import NihonshuFYI

with NihonshuFYI() as api:
    # Search sakes, breweries, glossary terms
    results = api.search("junmai daiginjo")
```

## Links

- [NihonshuFYI](https://nihonshufyi.com) — Sake encyclopedia with grades, breweries, and terminology
- [PyPI](https://pypi.org/project/nihonshufyi/)
- [GitHub](https://github.com/fyipedia/nihonshufyi)
- [FYIPedia](https://fyipedia.com) — Open-source developer tools ecosystem
