langsearch
Free web search and semantic reranking API for AGI applications. Use when you need to perform web searches, retrieve current information from the internet, or improve search accuracy with semantic reranking. Includes integration examples for building RAG (Retrieval-Augmented Generation) pipelines and LLM applications that require real-world context. Requires LANGSEARCH_API_KEY credential.
- License 许可
- MIT
- 最近更新
- 2026-06-07
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- langsearch
- metadata
- { "source": "https://langsearch.com/api-keys", "version": "1.0.1", "homepage": "https://langsearch.com", "openclaw": { "requires": { "env": [ "LANGSEARCH_API_KEY" ] }, "primaryEnv": "LANGSEARCH_API_KEY" }, "apiEndpoint": "https://api.langsearch.com/v1", "networkAccess": "LangSearch API (https://api.langsearch.com)", "supplyChainRisk": "Low - communicates only with official LangSearch API", "credentialsDescription": "API key for LangSearch service. Get a free key at https://langsearch.com/api-keys" }
- description
- Free web search and semantic reranking API for AGI applications. Use when you need to perform web searches, retrieve current information from the internet, or improve search accuracy with semantic reranking. Includes integration examples for building RAG (Retrieval-Augmented Generation) pipelines and LLM applications that require real-world context. Requires LANGSEARCH_API_KEY credential.
03 SKILL.md 正文
LangSearch
⚠️ Security & Credentials
Required Credentials:
LANGSEARCH_API_KEY- Your free LangSearch API key (required)
Security Best Practices:
- Get a free API key - Sign up at langsearch.com/api-keys
- Protect your API key - Never commit
.envfiles containingLANGSEARCH_API_KEYto version control - Use environment variables - Store the key in
.envor set viaexport LANGSEARCH_API_KEY="..." - Monitor usage - Check your API usage on the LangSearch dashboard
- Code inspection - This tool only uses the official LangSearch API. All communication is via HTTPS to
api.langsearch.com
Network Access:
- Only connects to:
https://api.langsearch.com(official LangSearch API) - No external data collection or telemetry
- No tracking or logging sent elsewhere
Overview
LangSearch provides free APIs for web search and semantic reranking. It combines keyword search precision with vector-based semantic matching, making it ideal for integrating current web information into LLM applications and building RAG systems.
Quick Start
Prerequisites
- Get a free API key at https://langsearch.com/api-keys
- Set your API key as an environment variable:
export LANGSEARCH_API_KEY="your-api-key"
Basic Web Search
The simplest way to search the web using LangSearch:
import requests
import json
import os
api_key = os.getenv("LANGSEARCH_API_KEY")
headers = {
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json"
}
query = "latest AI developments 2025"
payload = {
"query": query,
"count": 5,
"summary": True
}
response = requests.post(
"https://api.langsearch.com/v1/web-search",
headers=headers,
json=payload
)
results = response.json()
print(json.dumps(results, indent=2))
Or using cURL:
curl -X POST https://api.langsearch.com/v1/web-search \
-H "Authorization: Bearer $LANGSEARCH_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "latest AI developments 2025",
"count": 5,
"summary": true
}'
Web Search API
The web search endpoint retrieves information from billions of web documents using hybrid search (keyword + vector matching) with optional summaries.
Endpoint
POST https://api.langsearch.com/v1/web-search
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
query |
string | Yes | The search query |
count |
integer | No | Number of results to return (default: 10, max: 100) |
summary |
boolean | No | Include markdown summaries in results (default: false) |
freshness |
string | No | Filter results by freshness (day, week, month, year) |
Response Structure
The API returns an array of search results with:
title- Result titleurl- Result URLsnippet- Text excerpt from the pagesummary- Markdown formatted summary (ifsummary: truein request)score- Relevance score
Example Use Cases
Current Information Retrieval When your LLM needs up-to-date information:
# Search for recent developments
response = requests.post(
"https://api.langsearch.com/v1/web-search",
headers=headers,
json={
"query": "Python 3.14 release notes",
"count": 3,
"summary": True,
"freshness": "week"
}
)
Multi-Query Research Build context from multiple searches:
queries = [
"climate change mitigation strategies",
"renewable energy trends 2025",
"carbon capture technology"
]
all_results = []
for query in queries:
response = requests.post(
"https://api.langsearch.com/v1/web-search",
headers=headers,
json={"query": query, "count": 5, "summary": True}
)
all_results.extend(response.json())
Semantic Reranking API
Improve search accuracy by reranking results based on semantic relevance to your query.
Endpoint
POST https://api.langsearch.com/v1/rerank
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
query |
string | Yes | The search query for context |
documents |
array | Yes | Array of documents to rerank (each with title, text, etc.) |
model |
string | No | Reranking model (default: langsearch-rerank-1) |
top_n |
integer | No | Number of top results to return (default: 10) |
return_documents |
boolean | No | Include full documents in response (default: false) |
Example: Reranking Web Search Results
# Get initial search results
search_response = requests.post(
"https://api.langsearch.com/v1/web-search",
headers=headers,
json={"query": "machine learning deployment best practices", "count": 10}
)
search_results = search_response.json()
# Prepare documents for reranking
documents = [
{"title": r.get("title", ""), "text": r.get("snippet", "")}
for r in search_results
]
# Rerank for better relevance
rerank_response = requests.post(
"https://api.langsearch.com/v1/rerank",
headers=headers,
json={
"query": "best practices for deploying ML models in production",
"documents": documents,
"top_n": 5
}
)
reranked = rerank_response.json()
Building RAG Applications
Combine web search with LLM context for better information retrieval and generation:
def rag_query(user_question):
# Step 1: Search the web for relevant information
search_response = requests.post(
"https://api.langsearch.com/v1/web-search",
headers=headers,
json={
"query": user_question,
"count": 5,
"summary": True
}
)
search_results = search_response.json()
# Step 2: Extract summaries and URLs for context
context = "\n".join([
f"- {r['title']}: {r.get('summary', r.get('snippet', ''))}"
for r in search_results
])
# Step 3: Use with your LLM
# This is where you'd call your LLM with the context
rag_context = f"""
Based on recent web search results:
{context}
Answer the user's question: {user_question}
"""
return rag_context, search_results
Error Handling
Common HTTP status codes:
| Status | Meaning | Action |
|---|---|---|
| 200 | Success | Results returned normally |
| 401 | Unauthorized | Check API key is valid and set correctly |
| 429 | Rate limited | Retry with exponential backoff |
| 500 | Server error | Retry the request later |
See scripts/web_search_example.py for a complete example with error handling.
Resources
This skill includes example resource directories that demonstrate how to organize different types of bundled resources:
scripts/
Executable code (Python/Bash/etc.) that can be run directly to perform specific operations.
Examples from other skills:
- PDF skill:
fill_fillable_fields.py,extract_form_field_info.py- utilities for PDF manipulation - DOCX skill:
document.py,utilities.py- Python modules for document processing
Appropriate for: Python scripts, shell scripts, or any executable code that performs automation, data processing, or specific operations.
Note: Scripts may be executed without loading into context, but can still be read by Claude for patching or environment adjustments.
references/
Documentation and reference material intended to be loaded into context to inform Claude's process and thinking.
Examples from other skills:
- Product management:
communication.md,context_building.md- detailed workflow guides - BigQuery: API reference documentation and query examples
- Finance: Schema documentation, company policies
Appropriate for: In-depth documentation, API references, database schemas, comprehensive guides, or any detailed information that Claude should reference while working.
assets/
Files not intended to be loaded into context, but rather used within the output Claude produces.
Examples from other skills:
- Brand styling: PowerPoint template files (.pptx), logo files
- Frontend builder: HTML/React boilerplate project directories
- Typography: Font files (.ttf, .woff2)
Appropriate for: Templates, boilerplate code, document templates, images, icons, fonts, or any files meant to be copied or used in the final output.
Any unneeded directories can be deleted. Not every skill requires all three types of resources.
04 同仓库更多 Skills
crowd-prompting
A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.
ceaser
Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir/UltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).
ceaser-send
Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir/UltraHonk zero-knowledge proofs.
dilemm-ai
Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).
moldium
Post and manage content on the Moldium blog platform. Triggered by "post to Moldium", "write a blog post", "publish an article", etc.
arxiv-paper-reviews
Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date/category/interest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http://weakaccept.top:8000/.