dominusnode-crewai 1.0.0__tar.gz

dominusnode_crewai-1.0.0/.gitignore

@@ -0,0 +1,16 @@
+__pycache__/
+*.py[cod]
+*$py.class
+dist/
+build/
+*.egg-info/
+*.egg
+.pytest_cache/
+.coverage
+htmlcov/
+.venv/
+venv/
+.DS_Store
+.idea/
+.vscode/
+*.swp

dominusnode_crewai-1.0.0/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## 1.0.0 (2026-03-01)
+
+- Initial release
+- 4 CrewAI tools: proxy fetch, wallet balance, top-up (Stripe), top-up (PayPal)
+- SSRF protection, credential scrubbing, OFAC compliance

dominusnode_crewai-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dominus Node
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dominusnode_crewai-1.0.0/PKG-INFO

@@ -0,0 +1,221 @@
+Metadata-Version: 2.4
+Name: dominusnode-crewai
+Version: 1.0.0
+Summary: CrewAI tools for DomiNode rotating proxy service
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: crewai[tools]>=0.28.0
+Requires-Dist: dominusnode>=0.1.0
+Requires-Dist: httpx>=0.24.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# dominusnode-crewai
+
+CrewAI tools for the [DomiNode](https://dominusnode.com) rotating proxy-as-a-service platform. Gives your CrewAI agents the ability to fetch web content through rotating proxies, check wallet balance, and discover geo-targeting options.
+
+## Installation
+
+```bash
+pip install dominusnode-crewai
+```
+
+Or install from source:
+
+```bash
+cd integrations/crewai
+pip install -e ".[dev]"
+```
+
+## Environment Setup
+
+Set your DomiNode API key as an environment variable:
+
+```bash
+export DOMINUSNODE_API_KEY="dn_live_your_api_key_here"
+```
+
+Optionally configure the API base URL and proxy host:
+
+```bash
+export DOMINUSNODE_BASE_URL="https://api.dominusnode.com"
+export DOMINUSNODE_PROXY_HOST="proxy.dominusnode.com"
+```
+
+## Quick Start
+
+```python
+from crewai import Agent, Task, Crew
+from dominusnode_crewai import (
+    DominusNodeWebScrapeTool,
+    DominusNodeBalanceTool,
+    DominusNodeGeoTargetTool,
+)
+
+# Create tools (picks up DOMINUSNODE_API_KEY from environment)
+scrape_tool = DominusNodeWebScrapeTool()
+balance_tool = DominusNodeBalanceTool()
+geo_tool = DominusNodeGeoTargetTool()
+
+# Or pass the API key explicitly
+scrape_tool = DominusNodeWebScrapeTool(api_key="dn_live_...")
+
+# Create a CrewAI agent with DomiNode tools
+researcher = Agent(
+    role="Web Researcher",
+    goal="Gather competitive intelligence from geo-restricted sources",
+    backstory="You are a skilled researcher who can access content worldwide.",
+    tools=[scrape_tool, balance_tool, geo_tool],
+    verbose=True,
+)
+
+# Create a task
+task = Task(
+    description=(
+        "Check our remaining proxy budget, then fetch the homepage of "
+        "https://example.com through a US datacenter proxy. Summarize "
+        "the content and report the remaining balance."
+    ),
+    expected_output="A summary of the page content and remaining budget.",
+    agent=researcher,
+)
+
+# Run the crew
+crew = Crew(agents=[researcher], tasks=[task], verbose=True)
+result = crew.kickoff()
+print(result)
+```
+
+## Tools
+
+### DominusNodeWebScrapeTool
+
+Fetch web page content through DomiNode's rotating proxy network.
+
+**Parameters:**
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| `url` | str | Yes | - | The URL to fetch |
+| `country` | str | No | None | Two-letter country code (e.g., "US", "GB", "DE") |
+| `proxy_type` | str | No | "dc" | Proxy type: "dc" (datacenter, $3/GB) or "residential" ($5/GB) |
+
+**Example output:**
+```
+Status: 200
+Content-Type: text/html; charset=utf-8
+Body (1234 chars):
+<html>...
+```
+
+**Security:** URLs are validated to block SSRF attacks. Private IPs, localhost, metadata endpoints, file:// schemes, and other dangerous patterns are rejected.
+
+### DominusNodeBalanceTool
+
+Check remaining proxy balance and estimate browsing budget.
+
+**Parameters:** None
+
+**Example output:**
+```
+Wallet Balance: $30.00
+Estimated remaining:
+  - Datacenter proxy:    10.00 GB (at $3.00/GB)
+  - Residential proxy:   6.00 GB (at $5.00/GB)
+```
+
+### DominusNodeGeoTargetTool
+
+List available proxy server countries and geo-targeting options.
+
+**Parameters:** None
+
+**Example output:**
+```
+DomiNode Geo-Targeting Options:
+  Supported countries: US, GB, DE, JP, BR
+  Blocked countries:   CU, IR, KP, RU, SY
+  Targeting features:  US state targeting, City targeting
+  US states:           CA, NY, TX
+  Major US cities:     Los Angeles, New York, Houston
+  Rotation interval:   1-60 minutes
+```
+
+## Example Crew Configuration
+
+```python
+from crewai import Agent, Task, Crew, Process
+from dominusnode_crewai import (
+    DominusNodeWebScrapeTool,
+    DominusNodeBalanceTool,
+    DominusNodeGeoTargetTool,
+)
+
+# Tools
+scrape = DominusNodeWebScrapeTool()
+balance = DominusNodeBalanceTool()
+geo = DominusNodeGeoTargetTool()
+
+# Agents
+scout = Agent(
+    role="Geo Scout",
+    goal="Identify available proxy locations for the target region",
+    backstory="You map proxy coverage before the research team begins.",
+    tools=[geo, balance],
+)
+
+researcher = Agent(
+    role="Web Researcher",
+    goal="Collect data from target websites through rotating proxies",
+    backstory="You are an expert at gathering web data across different regions.",
+    tools=[scrape, balance],
+)
+
+analyst = Agent(
+    role="Data Analyst",
+    goal="Analyze and summarize the collected data",
+    backstory="You turn raw web data into actionable insights.",
+)
+
+# Tasks
+scout_task = Task(
+    description="Check which countries are available for proxy routing and verify we have sufficient budget.",
+    expected_output="A report of available countries and current budget.",
+    agent=scout,
+)
+
+research_task = Task(
+    description="Fetch the pricing pages of https://example.com from US and GB proxies. Compare the content.",
+    expected_output="Raw content from both regions with noted differences.",
+    agent=researcher,
+)
+
+analysis_task = Task(
+    description="Analyze the collected data and produce a comparison report.",
+    expected_output="A structured comparison of pricing differences by region.",
+    agent=analyst,
+)
+
+# Crew
+crew = Crew(
+    agents=[scout, researcher, analyst],
+    tasks=[scout_task, research_task, analysis_task],
+    process=Process.sequential,
+    verbose=True,
+)
+
+result = crew.kickoff()
+```
+
+## Running Tests
+
+```bash
+cd integrations/crewai
+pip install -e ".[dev]"
+pytest tests/ -v
+```
+
+## License
+
+MIT

dominusnode_crewai-1.0.0/README.md

@@ -0,0 +1,207 @@
+# dominusnode-crewai
+
+CrewAI tools for the [DomiNode](https://dominusnode.com) rotating proxy-as-a-service platform. Gives your CrewAI agents the ability to fetch web content through rotating proxies, check wallet balance, and discover geo-targeting options.
+
+## Installation
+
+```bash
+pip install dominusnode-crewai
+```
+
+Or install from source:
+
+```bash
+cd integrations/crewai
+pip install -e ".[dev]"
+```
+
+## Environment Setup
+
+Set your DomiNode API key as an environment variable:
+
+```bash
+export DOMINUSNODE_API_KEY="dn_live_your_api_key_here"
+```
+
+Optionally configure the API base URL and proxy host:
+
+```bash
+export DOMINUSNODE_BASE_URL="https://api.dominusnode.com"
+export DOMINUSNODE_PROXY_HOST="proxy.dominusnode.com"
+```
+
+## Quick Start
+
+```python
+from crewai import Agent, Task, Crew
+from dominusnode_crewai import (
+    DominusNodeWebScrapeTool,
+    DominusNodeBalanceTool,
+    DominusNodeGeoTargetTool,
+)
+
+# Create tools (picks up DOMINUSNODE_API_KEY from environment)
+scrape_tool = DominusNodeWebScrapeTool()
+balance_tool = DominusNodeBalanceTool()
+geo_tool = DominusNodeGeoTargetTool()
+
+# Or pass the API key explicitly
+scrape_tool = DominusNodeWebScrapeTool(api_key="dn_live_...")
+
+# Create a CrewAI agent with DomiNode tools
+researcher = Agent(
+    role="Web Researcher",
+    goal="Gather competitive intelligence from geo-restricted sources",
+    backstory="You are a skilled researcher who can access content worldwide.",
+    tools=[scrape_tool, balance_tool, geo_tool],
+    verbose=True,
+)
+
+# Create a task
+task = Task(
+    description=(
+        "Check our remaining proxy budget, then fetch the homepage of "
+        "https://example.com through a US datacenter proxy. Summarize "
+        "the content and report the remaining balance."
+    ),
+    expected_output="A summary of the page content and remaining budget.",
+    agent=researcher,
+)
+
+# Run the crew
+crew = Crew(agents=[researcher], tasks=[task], verbose=True)
+result = crew.kickoff()
+print(result)
+```
+
+## Tools
+
+### DominusNodeWebScrapeTool
+
+Fetch web page content through DomiNode's rotating proxy network.
+
+**Parameters:**
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| `url` | str | Yes | - | The URL to fetch |
+| `country` | str | No | None | Two-letter country code (e.g., "US", "GB", "DE") |
+| `proxy_type` | str | No | "dc" | Proxy type: "dc" (datacenter, $3/GB) or "residential" ($5/GB) |
+
+**Example output:**
+```
+Status: 200
+Content-Type: text/html; charset=utf-8
+Body (1234 chars):
+<html>...
+```
+
+**Security:** URLs are validated to block SSRF attacks. Private IPs, localhost, metadata endpoints, file:// schemes, and other dangerous patterns are rejected.
+
+### DominusNodeBalanceTool
+
+Check remaining proxy balance and estimate browsing budget.
+
+**Parameters:** None
+
+**Example output:**
+```
+Wallet Balance: $30.00
+Estimated remaining:
+  - Datacenter proxy:    10.00 GB (at $3.00/GB)
+  - Residential proxy:   6.00 GB (at $5.00/GB)
+```
+
+### DominusNodeGeoTargetTool
+
+List available proxy server countries and geo-targeting options.
+
+**Parameters:** None
+
+**Example output:**
+```
+DomiNode Geo-Targeting Options:
+  Supported countries: US, GB, DE, JP, BR
+  Blocked countries:   CU, IR, KP, RU, SY
+  Targeting features:  US state targeting, City targeting
+  US states:           CA, NY, TX
+  Major US cities:     Los Angeles, New York, Houston
+  Rotation interval:   1-60 minutes
+```
+
+## Example Crew Configuration
+
+```python
+from crewai import Agent, Task, Crew, Process
+from dominusnode_crewai import (
+    DominusNodeWebScrapeTool,
+    DominusNodeBalanceTool,
+    DominusNodeGeoTargetTool,
+)
+
+# Tools
+scrape = DominusNodeWebScrapeTool()
+balance = DominusNodeBalanceTool()
+geo = DominusNodeGeoTargetTool()
+
+# Agents
+scout = Agent(
+    role="Geo Scout",
+    goal="Identify available proxy locations for the target region",
+    backstory="You map proxy coverage before the research team begins.",
+    tools=[geo, balance],
+)
+
+researcher = Agent(
+    role="Web Researcher",
+    goal="Collect data from target websites through rotating proxies",
+    backstory="You are an expert at gathering web data across different regions.",
+    tools=[scrape, balance],
+)
+
+analyst = Agent(
+    role="Data Analyst",
+    goal="Analyze and summarize the collected data",
+    backstory="You turn raw web data into actionable insights.",
+)
+
+# Tasks
+scout_task = Task(
+    description="Check which countries are available for proxy routing and verify we have sufficient budget.",
+    expected_output="A report of available countries and current budget.",
+    agent=scout,
+)
+
+research_task = Task(
+    description="Fetch the pricing pages of https://example.com from US and GB proxies. Compare the content.",
+    expected_output="Raw content from both regions with noted differences.",
+    agent=researcher,
+)
+
+analysis_task = Task(
+    description="Analyze the collected data and produce a comparison report.",
+    expected_output="A structured comparison of pricing differences by region.",
+    agent=analyst,
+)
+
+# Crew
+crew = Crew(
+    agents=[scout, researcher, analyst],
+    tasks=[scout_task, research_task, analysis_task],
+    process=Process.sequential,
+    verbose=True,
+)
+
+result = crew.kickoff()
+```
+
+## Running Tests
+
+```bash
+cd integrations/crewai
+pip install -e ".[dev]"
+pytest tests/ -v
+```
+
+## License
+
+MIT

dominusnode_crewai-1.0.0/conftest.py

@@ -0,0 +1,60 @@
+"""Mock crewai and dominusnode modules before any test imports."""
+import sys
+from typing import Any, Optional
+from unittest.mock import MagicMock
+
+from pydantic import BaseModel, ConfigDict
+
+
+# ── Flexible mock type ──────────────────────────────────────────────────
+
+class _FlexType:
+    """Base that accepts any keyword arguments."""
+
+    def __init__(self, **kwargs):
+        for k, v in kwargs.items():
+            setattr(self, k, v)
+
+
+class ProxyUrlOptions(_FlexType):
+    pass
+
+
+# ── Mock dominusnode SDK ────────────────────────────────────────────────
+
+dominusnode_mock = MagicMock()
+dominusnode_types_mock = MagicMock()
+dominusnode_types_mock.ProxyUrlOptions = ProxyUrlOptions
+dominusnode_mock.DominusNodeClient = MagicMock
+dominusnode_mock.types = dominusnode_types_mock
+
+sys.modules.setdefault("dominusnode", dominusnode_mock)
+sys.modules.setdefault("dominusnode.types", dominusnode_types_mock)
+
+
+# ── Mock crewai ─────────────────────────────────────────────────────────
+
+crewai_mock = MagicMock()
+crewai_tools_mock = MagicMock()
+
+
+class BaseTool(BaseModel):
+    """Mock crewai BaseTool using Pydantic BaseModel (like real CrewAI)."""
+
+    model_config = ConfigDict(arbitrary_types_allowed=True)
+
+    name: str = ""
+    description: str = ""
+
+    def _run(self, **kwargs: Any) -> str:
+        raise NotImplementedError
+
+
+crewai_tools_mock.BaseTool = BaseTool
+crewai_mock.tools = crewai_tools_mock
+crewai_mock.Agent = MagicMock
+crewai_mock.Task = MagicMock
+crewai_mock.Crew = MagicMock
+
+sys.modules.setdefault("crewai", crewai_mock)
+sys.modules.setdefault("crewai.tools", crewai_tools_mock)

dominusnode_crewai-1.0.0/dominusnode_crewai/__init__.py

@@ -0,0 +1,60 @@
+"""CrewAI tools for DomiNode rotating proxy service.
+
+Provides CrewAI-compatible tools for fetching web content through rotating
+proxies, checking wallet balance, and listing available geo-targeting options
+through the DomiNode platform.
+
+Example::
+
+    from dominusnode_crewai import (
+        DominusNodeWebScrapeTool,
+        DominusNodeBalanceTool,
+        DominusNodeGeoTargetTool,
+    )
+
+    scrape_tool = DominusNodeWebScrapeTool(api_key="dn_live_...")
+    balance_tool = DominusNodeBalanceTool(api_key="dn_live_...")
+    geo_tool = DominusNodeGeoTargetTool(api_key="dn_live_...")
+
+    # Use with a CrewAI agent
+    from crewai import Agent
+    agent = Agent(
+        role="Web Researcher",
+        tools=[scrape_tool, balance_tool, geo_tool],
+        ...
+    )
+"""
+
+from .tools import (
+    DominusNodeAgenticTransactionsTool,
+    DominusNodeAgenticWalletBalanceTool,
+    DominusNodeBalanceTool,
+    DominusNodeCreateAgenticWalletTool,
+    DominusNodeDeleteAgenticWalletTool,
+    DominusNodeFreezeAgenticWalletTool,
+    DominusNodeFundAgenticWalletTool,
+    DominusNodeGeoTargetTool,
+    DominusNodeListAgenticWalletsTool,
+    DominusNodeTopupPaypalTool,
+    DominusNodeUnfreezeAgenticWalletTool,
+    DominusNodeUpdateWalletPolicyTool,
+    DominusNodeWebScrapeTool,
+    DominusNodeX402InfoTool,
+)
+
+__all__ = [
+    "DominusNodeWebScrapeTool",
+    "DominusNodeBalanceTool",
+    "DominusNodeGeoTargetTool",
+    "DominusNodeTopupPaypalTool",
+    "DominusNodeX402InfoTool",
+    "DominusNodeCreateAgenticWalletTool",
+    "DominusNodeFundAgenticWalletTool",
+    "DominusNodeAgenticWalletBalanceTool",
+    "DominusNodeListAgenticWalletsTool",
+    "DominusNodeAgenticTransactionsTool",
+    "DominusNodeFreezeAgenticWalletTool",
+    "DominusNodeUnfreezeAgenticWalletTool",
+    "DominusNodeDeleteAgenticWalletTool",
+    "DominusNodeUpdateWalletPolicyTool",
+]