Metadata-Version: 2.4
Name: tooltrace
Version: 0.1.0
Summary: Python SDK for the ToolTrace web intelligence API
Project-URL: Homepage, https://tooltrace.io
Project-URL: Documentation, https://tooltrace.io/docs
Project-URL: Repository, https://github.com/ToolTrace-io/tooltrace-python
Author-email: ToolTrace <info@tooltrace.io>
License-Expression: MIT
License-File: LICENSE
Keywords: ai-agents,metadata,rag,seo,tooltrace,web-scraping
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.9
Requires-Dist: httpx>=0.25.0
Description-Content-Type: text/markdown

# ToolTrace Python SDK

Official Python client for the [ToolTrace](https://tooltrace.io) web intelligence API. Extract content, metadata, links, structured data, SEO diagnostics, and technology stacks from any public webpage.

## Install

```bash
pip install tooltrace
```

## Quick start

```python
from tooltrace import ToolTrace

client = ToolTrace(api_key="your-key")

# Extract clean Markdown from a webpage
result = client.extract("https://example.com", include=["markdown", "metadata"])
print(result.markdown)
print(result.metadata.title)

# Detect technology stack
tech = client.tech_stack("https://example.com")
print(tech)

# Run an SEO audit
audit = client.seo_audit("https://example.com")
print(f"Score: {audit.score}/100")
for check in audit.checks:
    if not check.passed:
        print(f"  {check.severity}: {check.message}")
```

## Async support

```python
from tooltrace import AsyncToolTrace

async with AsyncToolTrace(api_key="your-key") as client:
    result = await client.extract("https://example.com")
    print(result.markdown)
```

## Available methods

| Method | Description | Credits |
|--------|-------------|---------|
| `client.extract(url)` | Markdown, text, metadata, links, schema, sections | 1-5 |
| `client.metadata(url)` | Title, description, Open Graph, Twitter cards | 1-5 |
| `client.links(url)` | Internal/external links with anchor text | 1-5 |
| `client.schema(url)` | JSON-LD structured data | 1-5 |
| `client.seo_audit(url)` | SEO score with weighted checks | 1-5 |
| `client.tech_stack(url)` | CMS, frameworks, analytics, CDN, hosting | 1-5 |
| `client.sitemap(url)` | Parse XML sitemaps | 1-5 |

All methods accept `render="never"` (1 credit, static), `render="auto"` (default), or `render="always"` (5 credits, browser).

## Get an API key

Sign up free at [tooltrace.io/signup](https://tooltrace.io/signup). 1,000 credits/month on the free plan.

## License

MIT
