crewai-fastaf 0.1.0__tar.gz

crewai_fastaf-0.1.0/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 FastAF
+
+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.

crewai_fastaf-0.1.0/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.5
+Name: crewai-fastaf
+Version: 0.1.0
+Summary: CrewAI tools for FastAF: SERP, news, jobs, Amazon, eBay and page-to-markdown APIs for AI agents.
+Project-URL: Homepage, https://fastaf.co
+Project-URL: Documentation, https://fastaf.co/docs/
+Project-URL: Source, https://github.com/fastaf-co/fastaf-integrations
+Author-email: FastAF <dev@fastaf.co>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai-agents,crewai,fastaf,scraping,serp,web-search,x402
+Requires-Python: >=3.10
+Requires-Dist: crewai>=0.100
+Requires-Dist: fastaf-sdk<0.2,>=0.1.0
+Requires-Dist: httpx>=0.27
+Provides-Extra: test
+Requires-Dist: pytest>=8; extra == 'test'
+Description-Content-Type: text/markdown
+
+# crewai-fastaf
+
+[CrewAI](https://crewai.com) tools for [FastAF](https://fastaf.co): Google SERP, News, Jobs, Amazon, eBay and page-to-Markdown APIs for AI agents.
+
+```bash
+pip install crewai-fastaf
+export FASTAF_API_KEY="your-key"   # https://fastaf.co/signup
+```
+
+Free tier: 2 calls after email verification; pay per call with x402 from $0.003.
+
+```python
+from crewai import Agent, Task, Crew
+from crewai_fastaf import FastAFSearchTool, FastAFPageToMarkdownTool
+
+researcher = Agent(
+    role="Researcher", goal="Find and summarize sources", backstory="Web researcher",
+    tools=[FastAFSearchTool(), FastAFPageToMarkdownTool()],
+)
+task = Task(description="Summarize what x402 is", expected_output="5 bullets", agent=researcher)
+print(Crew(agents=[researcher], tasks=[task]).kickoff())
+```
+
+Tools: `FastAFSearchTool`, `FastAFNewsTool`, `FastAFJobsTool`, `FastAFAmazonTool`, `FastAFEbayTool`, `FastAFPageToMarkdownTool`.
+
+Docs: https://fastaf.co/docs/ · License: MIT

crewai_fastaf-0.1.0/README.md

@@ -0,0 +1,26 @@
+# crewai-fastaf
+
+[CrewAI](https://crewai.com) tools for [FastAF](https://fastaf.co): Google SERP, News, Jobs, Amazon, eBay and page-to-Markdown APIs for AI agents.
+
+```bash
+pip install crewai-fastaf
+export FASTAF_API_KEY="your-key"   # https://fastaf.co/signup
+```
+
+Free tier: 2 calls after email verification; pay per call with x402 from $0.003.
+
+```python
+from crewai import Agent, Task, Crew
+from crewai_fastaf import FastAFSearchTool, FastAFPageToMarkdownTool
+
+researcher = Agent(
+    role="Researcher", goal="Find and summarize sources", backstory="Web researcher",
+    tools=[FastAFSearchTool(), FastAFPageToMarkdownTool()],
+)
+task = Task(description="Summarize what x402 is", expected_output="5 bullets", agent=researcher)
+print(Crew(agents=[researcher], tasks=[task]).kickoff())
+```
+
+Tools: `FastAFSearchTool`, `FastAFNewsTool`, `FastAFJobsTool`, `FastAFAmazonTool`, `FastAFEbayTool`, `FastAFPageToMarkdownTool`.
+
+Docs: https://fastaf.co/docs/ · License: MIT

crewai_fastaf-0.1.0/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "crewai-fastaf"
+version = "0.1.0"
+description = "CrewAI tools for FastAF: SERP, news, jobs, Amazon, eBay and page-to-markdown APIs for AI agents."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.10"
+authors = [{ name = "FastAF", email = "dev@fastaf.co" }]
+keywords = ["crewai", "fastaf", "serp", "web-search", "scraping", "x402", "ai-agents"]
+dependencies = ["crewai>=0.100", "fastaf-sdk>=0.1.0,<0.2", "httpx>=0.27"]
+
+[project.optional-dependencies]
+test = ["pytest>=8"]
+
+[project.urls]
+Homepage = "https://fastaf.co"
+Documentation = "https://fastaf.co/docs/"
+Source = "https://github.com/fastaf-co/fastaf-integrations"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/crewai_fastaf"]

crewai_fastaf-0.1.0/src/crewai_fastaf/__init__.py

@@ -0,0 +1,7 @@
+"""CrewAI tools for FastAF (https://fastaf.co)."""
+from crewai_fastaf.tools import (FastAFAmazonTool, FastAFEbayTool, FastAFJobsTool,
+                                 FastAFNewsTool, FastAFPageToMarkdownTool, FastAFSearchTool)
+
+__all__ = ["FastAFSearchTool", "FastAFNewsTool", "FastAFJobsTool", "FastAFAmazonTool",
+           "FastAFEbayTool", "FastAFPageToMarkdownTool"]
+__version__ = "0.1.0"

crewai_fastaf-0.1.0/src/crewai_fastaf/tools.py

@@ -0,0 +1,123 @@
+"""CrewAI tools for the FastAF API (https://fastaf.co)."""
+from __future__ import annotations
+
+import json
+import os
+from typing import Any, Dict, List, Optional, Type
+
+from crewai.tools import BaseTool, EnvVar
+from pydantic import BaseModel, ConfigDict, Field
+
+_ENV = [EnvVar(name="FASTAF_API_KEY", description="FastAF API key (https://fastaf.co/signup)",
+               required=True)]
+
+
+class _FastAFTool(BaseTool):
+    model_config = ConfigDict(arbitrary_types_allowed=True)
+    api_key: Optional[str] = Field(default=None, exclude=True, repr=False)
+    base_url: str = "https://api.fastaf.co"
+    client: Any = Field(default=None, exclude=True, repr=False)
+    env_vars: List[EnvVar] = _ENV
+    package_dependencies: List[str] = ["fastaf-sdk"]
+    endpoint: str = Field(default="", exclude=True)
+    defaults: Dict[str, Any] = Field(default_factory=dict, exclude=True)
+
+    def _get_client(self) -> Any:
+        if self.client is None:
+            key = self.api_key or os.environ.get("FASTAF_API_KEY")
+            if not key:
+                raise ValueError("FastAF API key missing. Set FASTAF_API_KEY or pass api_key=. "
+                                 "Get one at https://fastaf.co/signup")
+            from fastaf import FastAF
+            self.client = FastAF(key, base_url=self.base_url)
+        return self.client
+
+    def _call(self, params: Dict[str, Any]) -> str:
+        merged = {**self.defaults, **{k: v for k, v in params.items() if v is not None}}
+        data = self._get_client().request(self.endpoint, merged)
+        return data if isinstance(data, str) else json.dumps(data, ensure_ascii=False)
+
+
+class SearchSchema(BaseModel):
+    query: str = Field(..., description="Search query")
+    results: int = Field(5, ge=1, le=100, description="Number of results")
+    country: Optional[str] = Field(None, description="Two-letter country code")
+
+
+class FastAFSearchTool(_FastAFTool):
+    name: str = "FastAF Google Search"
+    description: str = "Search Google and return organic results as JSON."
+    args_schema: Type[BaseModel] = SearchSchema
+    endpoint: str = "serp"
+
+    def _run(self, query: str, results: int = 5, country: Optional[str] = None) -> str:
+        return self._call({"query": query, "results": results, "country": country})
+
+
+class FastAFNewsTool(_FastAFTool):
+    name: str = "FastAF Google News"
+    description: str = "Search Google News for recent articles."
+    args_schema: Type[BaseModel] = SearchSchema
+    endpoint: str = "news"
+
+    def _run(self, query: str, results: int = 5, country: Optional[str] = None) -> str:
+        return self._call({"query": query, "results": results, "country": country})
+
+
+class JobsSchema(BaseModel):
+    query: str = Field(..., description="Job title/keywords and optional location")
+    country: Optional[str] = Field(None, description="Two-letter country code")
+
+
+class FastAFJobsTool(_FastAFTool):
+    name: str = "FastAF Google Jobs"
+    description: str = "Search Google Jobs listings."
+    args_schema: Type[BaseModel] = JobsSchema
+    endpoint: str = "jobs"
+
+    def _run(self, query: str, country: Optional[str] = None) -> str:
+        return self._call({"query": query, "country": country})
+
+
+class AmazonSchema(BaseModel):
+    query: Optional[str] = Field(None, description="Product search query")
+    asin: Optional[str] = Field(None, description="Amazon ASIN for one product")
+    domain: Optional[str] = Field(None, description="Amazon domain, e.g. 'com', 'it'")
+
+
+class FastAFAmazonTool(_FastAFTool):
+    name: str = "FastAF Amazon"
+    description: str = "Get Amazon products and prices by search query or ASIN."
+    args_schema: Type[BaseModel] = AmazonSchema
+    endpoint: str = "amazon"
+
+    def _run(self, query: Optional[str] = None, asin: Optional[str] = None,
+             domain: Optional[str] = None) -> str:
+        if not query and not asin:
+            raise ValueError("Provide either query or asin")
+        return self._call({"query": query, "asin": asin, "domain": domain})
+
+
+class UrlSchema(BaseModel):
+    url: str = Field(..., description="Absolute https URL")
+
+
+class FastAFEbayTool(_FastAFTool):
+    name: str = "FastAF eBay"
+    description: str = "Extract structured data from an eBay URL (search, sold listings, item)."
+    args_schema: Type[BaseModel] = UrlSchema
+    endpoint: str = "ebay"
+
+    def _run(self, url: str) -> str:
+        return self._call({"url": url})
+
+
+class FastAFPageToMarkdownTool(_FastAFTool):
+    name: str = "FastAF Page to Markdown"
+    description: str = "Fetch a web page and return its content as LLM-ready Markdown."
+    args_schema: Type[BaseModel] = UrlSchema
+    endpoint: str = "scrape"
+    defaults: Dict[str, Any] = Field(default_factory=lambda: {"formats": "markdown"}, exclude=True)
+
+    def _run(self, url: str) -> str:
+        return self._call({"url": url})

crewai_fastaf-0.1.0/tests/test_tools.py

@@ -0,0 +1,48 @@
+import json
+
+import httpx
+import pytest
+from fastaf import FastAF
+
+from crewai_fastaf import (FastAFAmazonTool, FastAFEbayTool, FastAFJobsTool, FastAFNewsTool,
+                           FastAFPageToMarkdownTool, FastAFSearchTool)
+
+
+def _client():
+    def handler(req):
+        assert req.headers["authorization"] == "Bearer k"
+        return httpx.Response(200, json={"path": req.url.path, "params": dict(req.url.params)})
+    return FastAF("k", transport=httpx.MockTransport(handler))
+
+
+@pytest.mark.parametrize("cls,args,path", [
+    (FastAFSearchTool, {"query": "x402"}, "/v1/serp"),
+    (FastAFNewsTool, {"query": "ai"}, "/v1/news"),
+    (FastAFJobsTool, {"query": "python"}, "/v1/jobs"),
+    (FastAFAmazonTool, {"query": "ssd"}, "/v1/amazon"),
+    (FastAFEbayTool, {"url": "https://www.ebay.com/itm/1"}, "/v1/ebay"),
+    (FastAFPageToMarkdownTool, {"url": "https://example.com"}, "/v1/scrape"),
+])
+def test_run(cls, args, path):
+    out = json.loads(cls(client=_client()).run(**args))
+    assert out["path"] == path
+
+
+def test_markdown_default():
+    out = json.loads(FastAFPageToMarkdownTool(client=_client()).run(url="https://e.com"))
+    assert out["params"]["formats"] == "markdown"
+
+
+def test_missing_key(monkeypatch):
+    monkeypatch.delenv("FASTAF_API_KEY", raising=False)
+    with pytest.raises(ValueError):
+        FastAFSearchTool()._get_client()
+
+
+def test_env_vars_declared():
+    assert FastAFSearchTool().env_vars[0].name == "FASTAF_API_KEY"
+
+
+def test_amazon_needs_input():
+    with pytest.raises(ValueError):
+        FastAFAmazonTool(client=_client())._run()