Metadata-Version: 2.4
Name: benmilne-api
Version: 1.0.0
Summary: Python client for the benmilne.com public API
Project-URL: Homepage, https://benmilne.com
Project-URL: Documentation, https://benmilne.com/api
Project-URL: Repository, https://github.com/benmilne-com/agents
Project-URL: API Reference, https://benmilne.com/openapi.json
Project-URL: MCP Server, https://benmilne.com/mcp
Author: Ben Milne
License-Expression: MIT
License-File: LICENSE
Keywords: api,benmilne,fintech,mcp,payments
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Requires-Dist: httpx>=0.24
Description-Content-Type: text/markdown

# benmilne-api

Python client for the [benmilne.com](https://benmilne.com) public API.

All endpoints are public and unauthenticated. No API key required.

## Install

```bash
pip install benmilne-api
```

## Python

```python
from benmilne_api import BenmilneAPI

api = BenmilneAPI()

# List recent posts
posts = api.posts(page=1)

# Get a single post
post = api.post("rate-of-change")

# Full-text search
results = api.search("payments")

# Search in Spanish
results = api.search("pagos", lang="es")

# Site metadata
site = api.site()

# Categories and tags
categories = api.categories()
tags = api.tags()
```

## CLI

```bash
benmilne posts                     # List recent posts
benmilne post rate-of-change       # Get a single post
benmilne search "payments"         # Full-text search
benmilne search "pagos" --lang es  # Search in Spanish
benmilne categories                # List categories
benmilne tags                      # List tags
benmilne site                      # Site metadata
benmilne languages                 # Supported languages
```

## API Reference

- [API documentation](https://benmilne.com/api)
- [OpenAPI spec](https://benmilne.com/openapi.json)
- [MCP server](https://benmilne.com/mcp)
- [GraphQL](https://benmilne.com/graphql)

## License

MIT
