The whole web, as function calls.
Official Python SDK for WebUplink.
Installation
pip install webuplink
Quickstart
from webuplink import WebUplink
client = WebUplink() # reads WEBUPLINK_API_KEY from env
# Browse a page — get back structured, callable tools
page = client.browse("https://example.com")
print(page.summary)
print(page.tools) # [Tool(name='...', description='...', params=[...]), ...]
# Execute a tool discovered on the page
tool = page.tools[0]
result = client.browse(
session_id=page.session_id,
tool=tool.name,
params={tool.params[0].name: "some value"},
)
# Clean up
client.close_session(page.session_id)
Async
from webuplink import AsyncWebUplink
async with AsyncWebUplink() as client:
page = await client.browse("https://example.com")
print(page.tools)
What you can build
- AI agents that act on the web — browse any site, get back named, callable tool definitions, execute actions
- No selectors, no scraping — WebUplink understands pages and generates callable tools automatically
- Multi-step workflows — sessions persist across navigations, so your agent can search → filter → select → checkout
- Any website, zero configuration — works on sites you've never seen before
Error handling
Every non-2xx response raises a typed WebUplinkError carrying the machine-readable code, HTTP status_code, and request_id (cite it in support tickets):
from webuplink import WebUplink, WebUplinkError
client = WebUplink()
try:
page = client.browse("https://example.com")
except WebUplinkError as err:
print(err.code) # e.g. 'QUOTA_EXCEEDED', 'SITE_BLOCKED'
print(err.status_code) # e.g. 429, 502
print(err.request_id) # 'req-abc-123'
Transient error responses that carry retry_after (e.g. BROWSER_ERROR, AI_PROCESSING_ERROR) are retried automatically for observe-only requests. Raw transport failures for any browse POST are not retried and have retryable = False, because the server may already have received the request; idempotent GET/DELETE operations retain bounded transport retries. SITE_BLOCKED — the site served a bot-verification challenge or access-denied page; the request is not billed — carries no retry_after and is never auto-retried. Tool executions are never auto-retried (non-idempotent), and errors from tool-bearing calls expose retryable = False even when the server includes a diagnostic retry_after.
Full error reference at webuplink.ai/docs/errors.
Documentation
Full reference at webuplink.ai/docs.
Contributing
git clone https://github.com/webuplink-dev/webuplink-python.git
cd webuplink-python
pip install -e ".[dev]"
pytest
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 webuplink-1.1.0.tar.gz.
File metadata
- Download URL: webuplink-1.1.0.tar.gz
- Upload date:
- Size: 18.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 |
c68e71521afc94528249e7331108613598bb3ed39bacd3d4cbed2f3c2f2dde26
|
|
| MD5 |
a444415f0490439047a7af764cae1a82
|
|
| BLAKE2b-256 |
cd34c4cf84fd675782dfb3fdb0a106ff8a207805ef7ae610f1089cfd2b71b7c1
|
Provenance
The following attestation bundles were made for webuplink-1.1.0.tar.gz:
Publisher:
publish.yml on webuplink-dev/webuplink-python
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
webuplink-1.1.0.tar.gz -
Subject digest:
c68e71521afc94528249e7331108613598bb3ed39bacd3d4cbed2f3c2f2dde26 - Sigstore transparency entry: 2681826923
- Sigstore integration time:
-
Permalink:
webuplink-dev/webuplink-python@e99bd42db8e60fe4a2441a544fc24c64d95a6ac1 -
Branch / Tag:
refs/tags/v1.1.0 - Owner: https://github.com/webuplink-dev
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@e99bd42db8e60fe4a2441a544fc24c64d95a6ac1 -
Trigger Event:
release
-
Statement type:
File details
Details for the file webuplink-1.1.0-py3-none-any.whl.
File metadata
- Download URL: webuplink-1.1.0-py3-none-any.whl
- Upload date:
- Size: 14.6 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 |
61c3fe76d9d53c95a2ca4063d3af9033b9ff9fb73379b3d28221f2c0047ca54f
|
|
| MD5 |
b817b963914ab4362a68dcdade2b9580
|
|
| BLAKE2b-256 |
9d00fadce5bf9bca2ff815c128aef0491c61c67b5fa34af02ee86097fa28ce54
|
Provenance
The following attestation bundles were made for webuplink-1.1.0-py3-none-any.whl:
Publisher:
publish.yml on webuplink-dev/webuplink-python
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
webuplink-1.1.0-py3-none-any.whl -
Subject digest:
61c3fe76d9d53c95a2ca4063d3af9033b9ff9fb73379b3d28221f2c0047ca54f - Sigstore transparency entry: 2681826932
- Sigstore integration time:
-
Permalink:
webuplink-dev/webuplink-python@e99bd42db8e60fe4a2441a544fc24c64d95a6ac1 -
Branch / Tag:
refs/tags/v1.1.0 - Owner: https://github.com/webuplink-dev
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@e99bd42db8e60fe4a2441a544fc24c64d95a6ac1 -
Trigger Event:
release
-
Statement type:
