stackresolve
Official Python SDK for the StackResolve API.
StackResolve helps agents discover, evaluate, select, install, and use software (AgentReady), and compresses web research into structured company data calls (CompanyData). This SDK is a thin wrapper over the live REST API.
Install
pip install stackresolve
Requires Python 3.9+. Depends on httpx.
Quickstart
from stackresolve import StackResolve
sr = StackResolve(api_key="ar_...") # or set STACKRESOLVE_API_KEY
# 1. Audit a domain: AgentReady scores, facts, and issues.
report = sr.audit("stripe.com")
print(report["scores"]["agentready"], report["issues"])
# 2. Structured company data.
company = sr.get_company("vercel.com")
print(company["name"], company.get("description"))
# 3. Task -> ranked, agent-ready tools.
tools = sr.find_tools("send transactional email from a Python service")
print(tools["results"])
# 4. Run an Agent Discovery check (needs an API key).
discovery = sr.run_discovery("firecrawl")
print(discovery)
Authentication
Get an API key at stackresolve.dev. Pass it to the
constructor, or set the STACKRESOLVE_API_KEY environment variable:
sr = StackResolve(api_key="ar_...")
# or, reading STACKRESOLVE_API_KEY from the environment:
sr = StackResolve()
The key is sent as the x-api-key header on every request. Public endpoints
(audit, search, profiles, company data, ...) work without a key, subject to an
anonymous rate limit. Gated endpoints (monitors, usage, discovery runs) need one.
Point the client at a different host with base_url or the
STACKRESOLVE_BASE_URL environment variable:
sr = StackResolve(api_key="ar_...", base_url="https://api.stackresolve.dev")
Errors
Any non-2xx response raises a StackResolveError carrying the HTTP status and
the parsed body:
from stackresolve import StackResolve, StackResolveError
sr = StackResolve()
try:
sr.get_usage()
except StackResolveError as err:
print(err.status, err.body)
Methods
AgentReady:
audit(domain), find_tools(task), search(query, requirements=None),
compare(slugs), get_profile(slug), list_registry(...), get_categories(),
get_category(slug), get_discovery(slug), run_discovery(slug),
get_score_history(slug), generate(domain, openapi_url=None),
deploy(domain, openapi_url=None).
CompanyData:
get_company(domain), get_pricing(domain), get_competitors(domain),
research(domain, question=None), compare_companies(domains).
Monitors + account (API key required):
list_monitors(), add_monitor(slug, ...), run_monitor_now(slug),
get_usage(), get_my_profile().
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file stackresolve-0.1.0.tar.gz.
File metadata
- Download URL: stackresolve-0.1.0.tar.gz
- Upload date:
- Size: 4.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0eaa67ad31f7788c7e922be3ce6789b01fcb75342c8d38f169d61d317fe158bb
|
|
| MD5 |
a7ec52d02917676c1aa76e6f71ba60e9
|
|
| BLAKE2b-256 |
e0cf4a85a94b1a9c5ce3c9ae561cb2b9cdefc200ff65f9b07c8f19f7ad29a896
|
Provenance
The following attestation bundles were made for stackresolve-0.1.0.tar.gz:
Publisher:
publish-python-sdk.yml on autorevai/agentready
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
stackresolve-0.1.0.tar.gz -
Subject digest:
0eaa67ad31f7788c7e922be3ce6789b01fcb75342c8d38f169d61d317fe158bb - Sigstore transparency entry: 2554613166
- Sigstore integration time:
-
Permalink:
autorevai/agentready@26f41ebcbdf4f16919f80b6793fc8205c8e30853 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/autorevai
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-python-sdk.yml@26f41ebcbdf4f16919f80b6793fc8205c8e30853 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file stackresolve-0.1.0-py3-none-any.whl.
File metadata
- Download URL: stackresolve-0.1.0-py3-none-any.whl
- Upload date:
- Size: 5.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d04c8c17fce06e52a21a16de8678bb412a0461300022091e348094358faa4055
|
|
| MD5 |
c0d3f07b6d6b96e26cccd31768e6efb0
|
|
| BLAKE2b-256 |
fe32841f433fb1a61a3210b051e4072e3badf5263c1804b4c17d8e505b256938
|
Provenance
The following attestation bundles were made for stackresolve-0.1.0-py3-none-any.whl:
Publisher:
publish-python-sdk.yml on autorevai/agentready
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
stackresolve-0.1.0-py3-none-any.whl -
Subject digest:
d04c8c17fce06e52a21a16de8678bb412a0461300022091e348094358faa4055 - Sigstore transparency entry: 2554613558
- Sigstore integration time:
-
Permalink:
autorevai/agentready@26f41ebcbdf4f16919f80b6793fc8205c8e30853 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/autorevai
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-python-sdk.yml@26f41ebcbdf4f16919f80b6793fc8205c8e30853 -
Trigger Event:
workflow_dispatch
-
Statement type:
