strands-proxmint

Strands Agents tool for Proxmint proxies: let an agent read web pages from residential, datacenter or 4G/5G mobile IPs. Pick the exit country, state, city, ZIP or ASN, and keep one IP for up to two hours when a site needs it.

The agent passes a URL and, optionally, a country, and gets back the final URL, HTTP status, title and the page as readable text. Requests go straight from your machine to the Proxmint gateway (gw.proxmint.com). Nothing else sits in between, and bandwidth comes out of your own Proxmint account.

Install

pip install strands-proxmint

Credentials

Create an API key under Settings in the Proxmint dashboard and export it:

export PROXMINT_API_KEY="pmk_..."

The key reads the proxy login for the product you choose (residential by default). You can pass the proxy login instead, with PROXMINT_USERNAME and PROXMINT_PASSWORD or the username / password arguments.

Use it in an agent

from strands import Agent
from strands_proxmint import proxmint_fetch

agent = Agent(tools=[proxmint_fetch])
agent("What does the front page of example.com say when visited from Germany?")

proxmint_fetch uses the residential product and reads the credentials from the environment. For other settings, create a ProxmintTools and pass its proxmint_fetch:

from strands import Agent
from strands_proxmint import ProxmintTools

proxmint = ProxmintTools(product="mobile", country="us", city="New York", session_minutes=30)
agent = Agent(tools=[proxmint.proxmint_fetch])

Options on ProxmintTools:

You can also call the tool yourself: agent.tool.proxmint_fetch(url="https://example.com", country="de").

Gateway refusals (no bandwidth left, no IP matching the targeting, a blocked site) come back to the agent as an error result with a short message saying what to change.

Good to know

• Web traffic works on destination ports 80, 443, 8080, 8443, 8888 and 8090 (port access).
• A short list of sites, mostly banking and government, is refused by the network (blocked websites).
• City, state, ZIP and ASN targeting meter at 2x on residential, datacenter and mobile (targeting).
• The tool does not run JavaScript. It reads what the server sends.

Full guide: proxmint.com/docs/strands. Pricing: proxmint.com/pricing. Bandwidth is billed per GB and never expires.

Development

uv run --group test pytest

The tests run offline against a stand-in for the gateway.

License

MIT