Metadata-Version: 2.4
Name: pangolinfo-mcp
Version: 0.1.0
Summary: Pangolinfo Amazon Data MCP - Python client for 19 Amazon/WIPO/PACER data tools via the MCP protocol.
Project-URL: Homepage, https://www.pangolinfo.com/amazon-data-mcp/
Project-URL: Documentation, https://docs.pangolinfo.com
Project-URL: Repository, https://github.com/Pangolin-spg/pangolinfo-mcp
Project-URL: Changelog, https://github.com/Pangolin-spg/pangolinfo-mcp/releases
Project-URL: Issues, https://github.com/Pangolin-spg/pangolinfo-mcp/issues
Project-URL: Free API Key, https://tool.pangolinfo.com
Author-email: "PANGOLIN INFO TECH PTE. LTD." <support@pangolinfo.com>
License-Expression: MIT
License-File: LICENSE
Keywords: agent,ai,amazon,claude,data-extraction,mcp,pacer,pangolinfo,scraper,wipo
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
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: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Requires-Dist: httpx>=0.24
Provides-Extra: dev
Requires-Dist: build>=1.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: respx>=0.20; extra == 'dev'
Requires-Dist: twine>=4.0; extra == 'dev'
Description-Content-Type: text/markdown

# pangolinfo-mcp

Python client for the **Pangolinfo Amazon Data MCP** server — 19 Amazon / WIPO / PACER data tools callable from Python, no AI client required.

> Built and maintained by [PANGOLIN INFO TECH PTE. LTD.](https://www.pangolinfo.com)

## Why this package

The [Amazon Data MCP](https://www.pangolinfo.com/amazon-data-mcp/) gives AI agents 19 data tools via the MCP protocol. This package lets **Python developers** call those same tools from code — no Claude, Cursor, or any AI client needed.

- **19 tools** in one client: Amazon product, reviews, search, niches, bestsellers, AI SERP, WIPO, PACER and more
- **Zero dependencies** beyond `httpx` — no MCP SDK required
- **Sync** interface (async coming soon)
- **Same engine, same pricing** as the REST API and MCP server

## Installation

```
pip install pangolinfo-mcp
```

## Quick start

### 1. Get a permanent API key

Sign up at [tool.pangolinfo.com](https://tool.pangolinfo.com) and grab a permanent API key from Account Center.

### 2. Use the client

```python
from pangolinfo_mcp import PangolinfoMCPClient

client = PangolinfoMCPClient(api_key="your_permanent_api_key")

# Amazon product detail
product = client.get_amazon_product("B0DYTF8L2W")
print(product["title"])

# Keyword search
results = client.search_amazon("wireless earbuds")

# Best sellers in a category
bestsellers = client.list_bestsellers(category_id="172282")

# WIPO trademark check
trademarks = client.wipo_search("Nike")

# PACER patent litigation
cases = client.pacer_search("Apple Inc.")

# List all available tools
tools = client.list_tools()

client.close()
```

### Context manager

```python
with PangolinfoMCPClient(api_key="your_key") as client:
    product = client.get_amazon_product("B0DYTF8L2W")
```

## All 19 tools

### Amazon Core Data (5)
| Method | Description |
|---|---|
| `client.search_amazon(keyword)` | Search Amazon products |
| `client.get_amazon_product(asin)` | Full product detail |
| `client.get_amazon_reviews(asin)` | Paginated reviews |
| `client.list_seller_products(seller_id)` | Seller storefront |
| `client.scrape_url(url)` | Scrape any Amazon page |

### Category & Niche Analysis (8)
| Method | Description |
|---|---|
| `client.filter_niches(**metrics)` | Blue-ocean niche discovery |
| `client.filter_categories(**metrics)` | Category filtering |
| `client.search_categories(query)` | Full-text category search |
| `client.get_category_children(node_id)` | Browse node children |
| `client.get_category_tree()` | Root category tree |
| `client.batch_category_paths(category_ids)` | Batch category paths |
| `client.list_bestsellers(category_id)` | Best Sellers list |
| `client.list_new_releases(category_id)` | New Releases list |

### Search & SERP AI (3)
| Method | Description |
|---|---|
| `client.ai_search(query)` | AI Overview / AI Mode SERP |
| `client.keyword_trends(keyword)` | Keyword trend time-series |
| `client.search_amazon_alexa(query)` | Alexa for Shopping |

### Maps & IP Compliance (3)
| Method | Description |
|---|---|
| `client.search_local_maps(query)` | Maps POI data |
| `client.wipo_search(keyword)` | WIPO trademark search |
| `client.pacer_search(query)` | PACER patent litigation |

### Utility (1)
| Method | Description |
|---|---|
| `client.capabilities()` | List all live tools (free) |

## Generic tool call

```python
# Call any tool by name
result = client.call_tool("search_amazon", {"keyword": "laptop", "page": 2})
```

## Links

- **MCP product page:** [pangolinfo.com/amazon-data-mcp](https://www.pangolinfo.com/amazon-data-mcp/)
- **Documentation:** [docs.pangolinfo.com](https://docs.pangolinfo.com)
- **Get a free API key:** [tool.pangolinfo.com](https://tool.pangolinfo.com)
- **Source code:** [github.com/Pangolin-spg/pangolinfo-mcp](https://github.com/Pangolin-spg/pangolinfo-mcp)

## License

MIT — © PANGOLIN INFO TECH PTE. LTD.
