Metadata-Version: 2.4
Name: bizverify-agents
Version: 0.2.0
Summary: BizVerify tool wrappers for LLM agent frameworks — LangChain, CrewAI
Project-URL: Homepage, https://bizverify.co
Project-URL: Documentation, https://docs.bizverify.co/guides/ai-agents
Project-URL: Repository, https://github.com/BizVerify/bizverify-agents
Author-email: BizVerify <hello@bizverify.co>
License-Expression: MIT
License-File: LICENSE
Keywords: ai-agents,bizverify,business-verification,crewai,langchain,llm-tools
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Typing :: Typed
Requires-Python: >=3.9
Requires-Dist: bizverify>=0.1.0
Provides-Extra: crewai
Requires-Dist: crewai>=0.50.0; extra == 'crewai'
Provides-Extra: dev
Requires-Dist: pytest>=7; extra == 'dev'
Requires-Dist: ruff>=0.4; extra == 'dev'
Provides-Extra: langchain
Requires-Dist: langchain-core>=0.2.0; extra == 'langchain'
Description-Content-Type: text/markdown

# bizverify-agents

BizVerify tool wrappers for LLM agent frameworks. Provides ready-to-use tools for [LangChain](https://python.langchain.com/) and [CrewAI](https://www.crewai.com/) that call the [BizVerify](https://bizverify.co) business verification API.

## Installation

```bash
# LangChain
pip install bizverify-agents[langchain]

# CrewAI
pip install bizverify-agents[crewai]

# Both
pip install bizverify-agents[langchain,crewai]
```

## Authentication

Set your API key as an environment variable:

```bash
export BIZVERIFY_API_KEY="bv_live_..."
```

Or pass it directly:

```python
tools = BizVerifyTools(api_key="bv_live_...")
```

Get an API key at [bizverify.co](https://bizverify.co) -- new accounts receive 50 free credits.

## Usage

### LangChain

```python
from bizverify_agents.langchain import BizVerifyTools

tools = BizVerifyTools().get_tools()

# Use with any LangChain agent
from langchain.agents import AgentExecutor, create_tool_calling_agent
agent = create_tool_calling_agent(llm, tools, prompt)
executor = AgentExecutor(agent=agent, tools=tools)
executor.invoke({"input": "Verify Acme Corp in Florida"})
```

### CrewAI

```python
from bizverify_agents.crewai import BizVerifyTools

tools = BizVerifyTools().get_tools()

# Use with any CrewAI agent
from crewai import Agent
agent = Agent(
    role="Business Analyst",
    tools=tools,
    goal="Verify business registrations",
)
```

## Available Tools

| Tool | Description | Credits |
|------|-------------|---------|
| `verify_business` | Verify a business entity by name in a jurisdiction (quick or deep tier) | 1-25 |
| `search_entities` | Search for business entities across jurisdictions | 2/jurisdiction |
| `check_job_status` | Poll an async verification job | Free |
| `get_entity` | Retrieve cached entity data by ID | Free |
| `get_entity_history` | Get historical verification snapshots | 1 |
| `get_account` | Returns account details and credit balance | Free |
| `get_config` | Returns supported jurisdictions, pricing, and features | Free |
| `list_jurisdictions` | Returns all jurisdictions with capabilities and status | Free |
| `purchase_credits` | Creates a Stripe checkout session for credit purchase | Free |

## Links

- [BizVerify Documentation](https://docs.bizverify.co)
- [AI Agents Guide](https://docs.bizverify.co/guides/ai-agents)
- [API Reference](https://api.bizverify.co/reference)
- [Python SDK](https://pypi.org/project/bizverify/)
