langchain-serpex-python 0.1.4__tar.gz → 0.1.6__tar.gz

langchain_serpex_python-0.1.6/.gitignore

@@ -0,0 +1,5 @@
+__pycache__/
+*.py[cod]
+.pytest_cache/
+dist/
+*.egg-info/

langchain_serpex_python-0.1.6/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## 0.1.6 — 2026-09-22
+
+- docs: positioning — Serpex is a real-time web search API; README, docstrings and the tool description updated. Docstring examples now use the real package/module names (`langchain-serpex-python` / `langchain_serpex_python`).
+- `engine` deprecated (ignored by the API since 2026-06). The `engine` field is still accepted with the same default; request behaviour is unchanged. Class, tool name and exports unchanged.
+- Tests: engine names removed; integration tests import the real module. Removed committed `__pycache__` files.
+- package description, keywords and repository URLs updated.

{langchain_serpex_python-0.1.4 → langchain_serpex_python-0.1.6}/PKG-INFO

@@ -1,13 +1,14 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: langchain-serpex-python
-Version: 0.1.4
-Summary: An integration package connecting SERPEX and LangChain (Python)
+Version: 0.1.6
+Summary: LangChain integration for Serpex, a real-time web search API (Python)
 Project-URL: Homepage, https://docs.langchain.com/oss/python/integrations/providers/serpex
 Project-URL: Documentation, https://serpex.dev/docs
-Project-URL: Source, https://github.com/divyeshradadiya/langchain-serpex
-Project-URL: Repository, https://github.com/divyeshradadiya/langchain-serpex
+Project-URL: Source, https://github.com/divyeshradadiya/langchain-serpex-python
+Project-URL: Repository, https://github.com/divyeshradadiya/langchain-serpex-python
 License: MIT
 License-File: LICENSE
+Keywords: ai-agents,langchain,llm,rag,real-time-search,search,search-api,serpex,web-search
 Requires-Python: <4.0.0,>=3.9.0
 Requires-Dist: httpx>=0.27.0
 Requires-Dist: langchain-core<1.0.0,>=0.3.0
@@ -19,7 +20,7 @@ Description-Content-Type: text/markdown
 [![PyPI - License](https://img.shields.io/pypi/l/langchain-serpex-python)](https://opensource.org/licenses/MIT)
 [![Twitter](https://img.shields.io/twitter/url/https/twitter.com/langchainai.svg?style=social&label=Follow%20%40LangChainAI)](https://twitter.com/langchainai)
 
-This package contains the LangChain integration with SERPEX (Python).
+This package contains the LangChain integration with Serpex (Python).
 
 ## Installation
 
@@ -27,17 +28,19 @@ This package contains the LangChain integration with SERPEX (Python).
 pip install langchain-serpex-python
 ```
 
-## What is SERPEX?
+## What is Serpex?
 
-SERPEX is a powerful multi-engine search API that provides access to search results from Google, Bing, DuckDuckGo, Baidu, Yandex, and other search engines in JSON format. It's designed for developers building AI applications, SEO tools, market research platforms, and data aggregation services.
+Serpex is a real-time web search API. It returns structured JSON results
+(title, URL, snippet) for any query, and offers page content extraction that
+turns URLs into LLM-ready markdown. It's built for AI agents, LLM tools and
+RAG pipelines.
 
 ## Features
 
-- **Multi-Engine Support**: Search across Google, Bing, DuckDuckGo, Baidu, and Yandex
-- **Rich Results**: Get organic results, answer boxes, knowledge graphs, news, images, videos, and shopping results
-- **Localization**: Support for location-based and language-specific searches
-- **Real-time Data**: Access to current search results
-- **Easy Integration**: Simple API with comprehensive documentation
+- **Real-time web search**: current results for any query
+- **One search engine**: nothing to configure — no engine to pick
+- **LangChain-native**: a drop-in `BaseTool` for agents and chains
+- **Easy integration**: API key via argument or `SERPEX_API_KEY`
 
 ## Quick Start
 
@@ -51,11 +54,7 @@ Sign up at [SERPEX](https://serpex.dev) to get your API key.
 from langchain_serpex_python import SerpexSearchResults
 
 # Initialize the tool
-tool = SerpexSearchResults(
-    api_key="your-serpex-api-key",
-    engine="google",
-    num_results=10
-)
+tool = SerpexSearchResults(api_key="your-serpex-api-key")
 
 # Perform a search
 results = tool.invoke("latest AI developments")
@@ -70,11 +69,7 @@ from langchain_openai import ChatOpenAI
 from langchain.agents import initialize_agent, AgentType
 
 # Initialize the search tool
-search_tool = SerpexSearchResults(
-    api_key="your-serpex-api-key",
-    engine="google",
-    num_results=5
-)
+search_tool = SerpexSearchResults(api_key="your-serpex-api-key")
 
 # Initialize the LLM
 llm = ChatOpenAI(temperature=0)
@@ -100,37 +95,18 @@ from langchain_serpex_python import SerpexSearchResults
 # Configure with advanced parameters
 tool = SerpexSearchResults(
     api_key="your-serpex-api-key",
-    engine="google",
-    num_results=20,
-    gl="us",  # Country code
-    hl="en",  # Language code
-    location="New York",  # Specific location
-    time_period="m",  # Results from past month
-    safe_search="moderate"
+    time_range="month"
 )
 
-# Search for location-specific results
 results = tool.invoke("best restaurants")
 print(results)
 ```
 
-### Different Search Engines
+### The `engine` parameter (deprecated)
 
-```python
-from langchain_serpex_python import SerpexSearchResults
-
-# Google Search
-google_tool = SerpexSearchResults(api_key="your-key", engine="google")
-google_results = google_tool.invoke("Python programming")
-
-# Bing Search
-bing_tool = SerpexSearchResults(api_key="your-key", engine="bing")
-bing_results = bing_tool.invoke("Python programming")
-
-# DuckDuckGo Search
-ddg_tool = SerpexSearchResults(api_key="your-key", engine="duckduckgo")
-ddg_results = ddg_tool.invoke("Python programming")
-```
+Serpex is one search engine, so there is nothing to select. `engine` is
+deprecated and ignored by the Serpex API since 2026-06; it is still accepted
+so existing code keeps working.
 
 ## Configuration
 
@@ -152,14 +128,10 @@ tool = SerpexSearchResults()  # Will use SERPEX_API_KEY from environment
 
 ### Parameters
 
-- `api_key` (str): Your SERPEX API key (required)
-- `engine` (str): Search engine to use - "google", "bing", "duckduckgo", "baidu", "yandex" (default: "google")
-- `num_results` (int): Number of results to return, 1-100 (default: 10)
-- `gl` (str): Country code for localized results (e.g., "us", "uk", "ca")
-- `hl` (str): Language code (e.g., "en", "es", "fr")
-- `location` (str): Specific location for localized results
-- `time_period` (str): Time filter - "d" (day), "w" (week), "m" (month), "y" (year)
-- `safe_search` (str): Safe search filter - "off", "moderate", "strict"
+- `api_key` (str): Your Serpex API key (required)
+- `engine` (str): **Deprecated** — ignored by the Serpex API (default: "auto"); still accepted
+- `category` (str): Search category - currently only "web" is supported (default: "web")
+- `time_range` (str): Time filter - "all", "day", "week", "month", "year"
 
 ## Documentation
 

{langchain_serpex_python-0.1.4 → langchain_serpex_python-0.1.6}/README.md

@@ -4,7 +4,7 @@
 [![PyPI - License](https://img.shields.io/pypi/l/langchain-serpex-python)](https://opensource.org/licenses/MIT)
 [![Twitter](https://img.shields.io/twitter/url/https/twitter.com/langchainai.svg?style=social&label=Follow%20%40LangChainAI)](https://twitter.com/langchainai)
 
-This package contains the LangChain integration with SERPEX (Python).
+This package contains the LangChain integration with Serpex (Python).
 
 ## Installation
 
@@ -12,17 +12,19 @@ This package contains the LangChain integration with SERPEX (Python).
 pip install langchain-serpex-python
 ```
 
-## What is SERPEX?
+## What is Serpex?
 
-SERPEX is a powerful multi-engine search API that provides access to search results from Google, Bing, DuckDuckGo, Baidu, Yandex, and other search engines in JSON format. It's designed for developers building AI applications, SEO tools, market research platforms, and data aggregation services.
+Serpex is a real-time web search API. It returns structured JSON results
+(title, URL, snippet) for any query, and offers page content extraction that
+turns URLs into LLM-ready markdown. It's built for AI agents, LLM tools and
+RAG pipelines.
 
 ## Features
 
-- **Multi-Engine Support**: Search across Google, Bing, DuckDuckGo, Baidu, and Yandex
-- **Rich Results**: Get organic results, answer boxes, knowledge graphs, news, images, videos, and shopping results
-- **Localization**: Support for location-based and language-specific searches
-- **Real-time Data**: Access to current search results
-- **Easy Integration**: Simple API with comprehensive documentation
+- **Real-time web search**: current results for any query
+- **One search engine**: nothing to configure — no engine to pick
+- **LangChain-native**: a drop-in `BaseTool` for agents and chains
+- **Easy integration**: API key via argument or `SERPEX_API_KEY`
 
 ## Quick Start
 
@@ -36,11 +38,7 @@ Sign up at [SERPEX](https://serpex.dev) to get your API key.
 from langchain_serpex_python import SerpexSearchResults
 
 # Initialize the tool
-tool = SerpexSearchResults(
-    api_key="your-serpex-api-key",
-    engine="google",
-    num_results=10
-)
+tool = SerpexSearchResults(api_key="your-serpex-api-key")
 
 # Perform a search
 results = tool.invoke("latest AI developments")
@@ -55,11 +53,7 @@ from langchain_openai import ChatOpenAI
 from langchain.agents import initialize_agent, AgentType
 
 # Initialize the search tool
-search_tool = SerpexSearchResults(
-    api_key="your-serpex-api-key",
-    engine="google",
-    num_results=5
-)
+search_tool = SerpexSearchResults(api_key="your-serpex-api-key")
 
 # Initialize the LLM
 llm = ChatOpenAI(temperature=0)
@@ -85,37 +79,18 @@ from langchain_serpex_python import SerpexSearchResults
 # Configure with advanced parameters
 tool = SerpexSearchResults(
     api_key="your-serpex-api-key",
-    engine="google",
-    num_results=20,
-    gl="us",  # Country code
-    hl="en",  # Language code
-    location="New York",  # Specific location
-    time_period="m",  # Results from past month
-    safe_search="moderate"
+    time_range="month"
 )
 
-# Search for location-specific results
 results = tool.invoke("best restaurants")
 print(results)
 ```
 
-### Different Search Engines
+### The `engine` parameter (deprecated)
 
-```python
-from langchain_serpex_python import SerpexSearchResults
-
-# Google Search
-google_tool = SerpexSearchResults(api_key="your-key", engine="google")
-google_results = google_tool.invoke("Python programming")
-
-# Bing Search
-bing_tool = SerpexSearchResults(api_key="your-key", engine="bing")
-bing_results = bing_tool.invoke("Python programming")
-
-# DuckDuckGo Search
-ddg_tool = SerpexSearchResults(api_key="your-key", engine="duckduckgo")
-ddg_results = ddg_tool.invoke("Python programming")
-```
+Serpex is one search engine, so there is nothing to select. `engine` is
+deprecated and ignored by the Serpex API since 2026-06; it is still accepted
+so existing code keeps working.
 
 ## Configuration
 
@@ -137,14 +112,10 @@ tool = SerpexSearchResults()  # Will use SERPEX_API_KEY from environment
 
 ### Parameters
 
-- `api_key` (str): Your SERPEX API key (required)
-- `engine` (str): Search engine to use - "google", "bing", "duckduckgo", "baidu", "yandex" (default: "google")
-- `num_results` (int): Number of results to return, 1-100 (default: 10)
-- `gl` (str): Country code for localized results (e.g., "us", "uk", "ca")
-- `hl` (str): Language code (e.g., "en", "es", "fr")
-- `location` (str): Specific location for localized results
-- `time_period` (str): Time filter - "d" (day), "w" (week), "m" (month), "y" (year)
-- `safe_search` (str): Safe search filter - "off", "moderate", "strict"
+- `api_key` (str): Your Serpex API key (required)
+- `engine` (str): **Deprecated** — ignored by the Serpex API (default: "auto"); still accepted
+- `category` (str): Search category - currently only "web" is supported (default: "web")
+- `time_range` (str): Time filter - "all", "day", "week", "month", "year"
 
 ## Documentation
 

langchain_serpex_python-0.1.6/langchain_serpex_python/__init__.py

@@ -0,0 +1,9 @@
+"""Serpex integration for LangChain.
+
+This module provides a LangChain tool for real-time web search with Serpex,
+a real-time web search API.
+"""
+
+from langchain_serpex_python.tools import SerpexSearchResults
+
+__all__ = ["SerpexSearchResults"]

{langchain_serpex_python-0.1.4 → langchain_serpex_python-0.1.6}/langchain_serpex_python/tools.py

@@ -10,27 +10,26 @@ from pydantic import Field, SecretStr, model_validator
 
 
 class SerpexSearchResults(BaseTool):
-    """Tool for searching the web using the SERPEX API.
+    """Tool for real-time web search with Serpex.
 
-    SERPEX provides multi-engine search results from Google, Bing, DuckDuckGo,
-    Brave, Yahoo, and Yandex search engines in JSON format.
+    Serpex is a real-time web search API that returns results as JSON.
 
     Setup:
-        Install `langchain-serpex` and set environment variable `SERPEX_API_KEY`.
+        Install `langchain-serpex-python` and set environment variable
+        `SERPEX_API_KEY`.
 
         ```bash
-        pip install -U langchain-serpex
+        pip install -U langchain-serpex-python
         export SERPEX_API_KEY="your-serpex-api-key"
         ```
 
     Instantiation:
         ```python
-        from langchain_serpex import SerpexSearchResults
+        from langchain_serpex_python import SerpexSearchResults
 
         # With explicit API key
         tool = SerpexSearchResults(
             api_key="your-serpex-api-key",
-            engine="auto",  # or google, bing, duckduckgo, brave, yahoo, yandex
             time_range="day"  # optional: all, day, week, month, year
         )
 
@@ -47,14 +46,13 @@ class SerpexSearchResults(BaseTool):
         # With specific parameters
         results = tool.invoke({
             "query": "Python programming",
-            "engine": "google",
             "time_range": "week"
         })
         ```
 
     Example with Agent:
         ```python
-        from langchain_serpex import SerpexSearchResults
+        from langchain_serpex_python import SerpexSearchResults
         from langchain_openai import ChatOpenAI
         from langchain.agents import initialize_agent, AgentType
 
@@ -73,19 +71,18 @@ class SerpexSearchResults(BaseTool):
 
     name: str = "serpex_search"
     description: str = (
-        "A powerful multi-engine web search tool. "
+        "A real-time web search tool. "
         "Useful for answering questions about current events, "
         "finding information from the web, and getting real-time data. "
-        "Input should be a search query string. "
-        "Supports automatic routing with retry logic and multiple search engines "
-        "(Google, Bing, DuckDuckGo, Brave, Yahoo, Yandex)."
+        "Input should be a search query string."
     )
 
     api_key: SecretStr = Field(default_factory=lambda: SecretStr(""))
     engine: str = Field(
         default="auto",
         description=(
-            "Search engine: auto, google, bing, duckduckgo, brave, yahoo, yandex"
+            "Deprecated: ignored by the Serpex API since 2026-06 (Serpex is a "
+            "single search engine). Still accepted for backward compatibility."
         ),
     )
     category: str = Field(
@@ -95,7 +92,7 @@ class SerpexSearchResults(BaseTool):
     time_range: Optional[str] = Field(
         default=None,
         description=(
-            "Time range: all, day, week, month, year (not supported by Brave)"
+            "Time range: all, day, week, month, year"
         ),
     )
 

{langchain_serpex_python-0.1.4 → langchain_serpex_python-0.1.6}/pyproject.toml

@@ -4,8 +4,9 @@ build-backend = "hatchling.build"
 
 [project]
 name = "langchain-serpex-python"
-version = "0.1.4"
-description = "An integration package connecting SERPEX and LangChain (Python)"
+version = "0.1.6"
+description = "LangChain integration for Serpex, a real-time web search API (Python)"
+keywords = ["langchain", "serpex", "search", "search-api", "web-search", "real-time-search", "ai-agents", "llm", "rag"]
 readme = "README.md"
 license = {text = "MIT"}
 authors = []
@@ -18,8 +19,8 @@ dependencies = [
 [project.urls]
 Homepage = "https://docs.langchain.com/oss/python/integrations/providers/serpex"
 Documentation = "https://serpex.dev/docs"
-Source = "https://github.com/divyeshradadiya/langchain-serpex"
-Repository = "https://github.com/divyeshradadiya/langchain-serpex"
+Source = "https://github.com/divyeshradadiya/langchain-serpex-python"
+Repository = "https://github.com/divyeshradadiya/langchain-serpex-python"
 
 [dependency-groups]
 test = [

{langchain_serpex_python-0.1.4 → langchain_serpex_python-0.1.6}/tests/integration_tests/test_tools.py

@@ -5,13 +5,13 @@ import os
 import pytest
 from pydantic import SecretStr
 
-from langchain_serpex import SerpexSearchResults
+from langchain_serpex_python import SerpexSearchResults
 
 
 @pytest.mark.compile
 def test_import() -> None:
     """Test that the module can be imported."""
-    from langchain_serpex import SerpexSearchResults  # noqa: F401
+    from langchain_serpex_python import SerpexSearchResults  # noqa: F401
 
 
 @pytest.mark.skipif("SERPEX_API_KEY" not in os.environ, reason="SERPEX_API_KEY not set")
@@ -30,15 +30,13 @@ def test_serpex_search_integration() -> None:
 
 
 @pytest.mark.skipif("SERPEX_API_KEY" not in os.environ, reason="SERPEX_API_KEY not set")
-def test_serpex_different_engines() -> None:
-    """Test search with different engines."""
+def test_serpex_deprecated_engine_still_accepted() -> None:
+    """The deprecated `engine` value is still accepted (and ignored by the API)."""
     api_key = os.getenv("SERPEX_API_KEY")
     if not api_key:
         pytest.skip("SERPEX_API_KEY not set")
 
-    engines = ["google", "bing", "duckduckgo"]
-
-    for engine in engines:
+    for engine in ["auto", "legacy-value"]:
         tool = SerpexSearchResults(api_key=SecretStr(api_key), engine=engine)
         result = tool._run("test query")
         assert result

{langchain_serpex_python-0.1.4 → langchain_serpex_python-0.1.6}/tests/unit_tests/test_tools.py

@@ -6,7 +6,7 @@ from typing import Any
 import pytest
 from pydantic import SecretStr
 
-from langchain_serpex import SerpexSearchResults
+from langchain_serpex_python import SerpexSearchResults
 
 
 def test_serpex_initialization() -> None:
@@ -28,33 +28,33 @@ def test_serpex_custom_parameters() -> None:
     """Test that Serpex accepts custom parameters."""
     tool = SerpexSearchResults(
         api_key=SecretStr("test_api_key"),
-        engine="google",
+        engine="legacy-value",
         category="web",
         time_range="day",
     )
-    assert tool.engine == "google"
+    assert tool.engine == "legacy-value"
     assert tool.time_range == "day"
 
 
 def test_serpex_build_params() -> None:
     """Test that _build_params creates correct parameters."""
     tool = SerpexSearchResults(
-        api_key=SecretStr("test_key"), engine="bing", time_range="week"
+        api_key=SecretStr("test_key"), engine="legacy-a", time_range="week"
     )
     params = tool._build_params("test query")
 
     assert params["q"] == "test query"
-    assert params["engine"] == "bing"
+    assert params["engine"] == "legacy-a"
     assert params["category"] == "web"
     assert params["time_range"] == "week"
 
 
 def test_serpex_build_params_override() -> None:
     """Test that _build_params allows overrides."""
-    tool = SerpexSearchResults(api_key=SecretStr("test_key"), engine="google")
-    params = tool._build_params("test query", engine="duckduckgo", time_range="month")
+    tool = SerpexSearchResults(api_key=SecretStr("test_key"), engine="legacy-a")
+    params = tool._build_params("test query", engine="legacy-b", time_range="month")
 
-    assert params["engine"] == "duckduckgo"
+    assert params["engine"] == "legacy-b"
     assert params["time_range"] == "month"
 
 

langchain_serpex_python-0.1.4/langchain_serpex_python/__init__.py

@@ -1,10 +0,0 @@
-"""SERPEX integration for LangChain.
-
-This module provides tools for searching the web using the SERPEX API,
-which supports multiple search engines including Google, Bing, DuckDuckGo,
-Baidu, and Yandex.
-"""
-
-from langchain_serpex_python.tools import SerpexSearchResults
-
-__all__ = ["SerpexSearchResults"]