Skip to main content
Perigon 是一个综合新闻 API，提供对来自全球数千个来源的新闻文章、故事、元数据和 Wikipedia 页面中的实时上下文信息的访问。

​
安装与设置

Perigon 集成存在于其自己的 合作伙伴包 中。您可以通过以下方式安装： 
pip install -qU langchain-perigon
要使用该包，您还需要将 PERIGON_API_KEY 环境变量设置为您的 Perigon API 密钥。

​
检索器

Perigon 提供两种检索器：

​
ArticlesRetriever

此检索器根据给定查询和可选过滤器检索文章。 参见 完整使用示例。 
# 确保 PERIGON_API_KEY 环境变量已设置为您的 Perigon API 密钥
from langchain_perigon import ArticlesRetriever, ArticlesFilter

# 创建具有特定结果数量的检索器
retriever = ArticlesRetriever(k=12)

# 配置过滤器选项以排除转载并专注于美国文章
options: ArticlesFilter = {
    "showReprints": False,  # 排除重复/转载文章
    "filter": {"country": "us"},  # 仅限美国新闻
}

try:
    documents = retriever.invoke("Recent big tech layoffs", options=options)

    # 在访问前检查是否有结果
    if documents:
        print(f"First document: {documents[0].page_content[:200]}...")
    else:
        print("No articles found for the given query.")
except Exception as e:
    print(f"Error retrieving articles: {e}")
您可以在标准检索管道中使用 ArticlesRetriever：

​
WikipediaRetriever

此检索器根据给定查询和可选过滤器检索 Wikipedia 页面。 参见 完整使用示例。 
# 确保 PERIGON_API_KEY 环境变量已设置为您的 Perigon API 密钥
from langchain_perigon import WikipediaRetriever

# 创建具有特定结果数量的检索器
retriever = WikipediaRetriever(k=12)

try:
    documents = retriever.invoke("machine learning")

    # 安全地访问结果并处理错误
    if documents:
        print(f"First document: {documents[0].page_content[:200]}...")
    else:
        print("No Wikipedia articles found for the given query.")
except Exception as e:
    print(f"Error retrieving Wikipedia articles: {e}")
您可以在标准检索管道中使用 WikipediaRetriever：
在 GitHub 上编辑此页面 或 提交问题。
将这些文档连接 到 Claude、VSCode 等，通过 MCP 获取实时答案。