Developer guide: Building news monitoring agents with Nimble (examples)
Three worked examples of news monitoring agents that pull from primary sources, with Search API and Web Search Agent code.


Developer guide: Building news monitoring agents with Nimble (examples)
Three worked examples of news monitoring agents that pull from primary sources, with Search API and Web Search Agent code.


News monitoring is easy when you just need the latest headlines, since generic web search handles popular stories well. It gets harder when the use case requires domain expertise, where the answers sit in primary filings, carrier advisories, government portals, and local outlets that popularity-based search rarely surfaces.
In this guide, we'll use Nimble's Search API and Web Search Agents to build news monitoring agents that search the web for these sources, across three real use cases:
- Company and industry event monitoring: Track significant developments within a company or sector and rank them by importance.
- Breaking event and situation monitoring: Consolidate fragmented reports on fast-moving events into a single, verified timeline.
- Supply chain disruption monitoring: Collect and prioritize simultaneous disruptions on a trade lane by type and severity.
Key Takeaways
- Generic web search often misses key developments and sources essential for effective monitoring.
- Nimble Search reliably retrieves deep web data at about half the cost of standard LLM web search solutions.
- Nimble Search goes beyond standard results by supporting JavaScript rendering, anti-bot measures, page interaction, and full-page extraction.
- Web Search Agents automate the entire monitoring workflow, from planning to delivering synthesized, cited output.
- Web Search Agents learn from recurring use cases, providing deeper and more complete context with each run.
Use Case 1: Company and Industry Event Monitoring
Competitive intelligence, investor relations, and corporate strategy teams require early signals on market-moving events such as product launches, executive departures, lawsuits, partnerships, or regulatory actions. These signals are dispersed across company newsrooms, trade and financial press, and regulatory portals. As a result, generic web search often returns popular summaries while missing the underlying primary sources.
This use case builds a monitoring agent that finds those developments for a given company or sector, categorizes them, and returns a ranked summary with evidence. It is shown first with the Search API, where the application drives the workflow, then with a Web Search Agent, where Nimble runs the entire research process.
See the company-event-monitoring-agent we built here.
Monitoring with Nimble's Search API
Effective monitoring needs more than one broad query. Instead of a single catch-all search, this approach runs a targeted query for each category of development, product launches, leadership changes, and legal or regulatory activity, each executed against Nimble's Search API with deep retrieval enabled.
As a result, each result includes full-page content rather than a snippet. For OpenAI, that surfaced the company newsroom, national business press such as CNBC and TechCrunch, and primary legal and regulatory sources.
Each category is a single Search API call with deep retrieval on:
result = nimble.search(
query="OpenAI executive leadership change",
full_contents=True,
)One representative result from each query shows the range and depth, with the retrieved content trimmed:
[
{
"query": "OpenAI product launch",
"title": "Product News and Updates",
"url": "https://openai.com/news/product-releases/",
"source": "company newsroom",
"content": "Read the latest OpenAI product news, including releases, announcements, and updates across ChatGPT, Codex, AI models, and developer tools ...",
"extracted_characters": 6189
},
{
"query": "OpenAI executive leadership change",
"title": "OpenAI talent exodus raises 'huge red flag' ahead of IPO",
"url": "https://www.cnbc.com/2026/08/14/open-ai-ipo-red-flag.html",
"source": "national business press",
"content": "The sudden departure of OpenAI revenue chief Denise Dresser this week came days after longtime exec Brad Lightcap said he was leaving ...",
"extracted_characters": 22054
},The agent reads the full-page content from each search result, giving priority to primary sources like company newsrooms, regulator sites, and filings, and uses reputable press to corroborate them. It then merges repeat coverage of the same event, tags each development by type and relevance, and ranks them by significance, with a date and source URL attached to every item.
Monitoring with Nimble's Agent API
The Search API provides your application with clean web data for analysis. In contrast, the Agent API allows you to submit a single research objective, and Nimble Web Search Agents plan and execute the entire investigation, returning a research brief grounded in the search results.
Given the objective to identify OpenAI's most significant developments over the past 30 days, including launches, partnerships, leadership, legal and regulatory activity, and competitive moves, the Web Search Agent divided the task into twelve sub-questions, evaluated about 120 sources, and returned a structured, ranked brief with 27 cited claims instead of a list of links.
The entire run starts from one request, a single objective handed to the Web Search Agent:
from langchain.agents import create_agent
from langchain_nimble import NimbleToolkit
from langchain_anthropic import ChatAnthropic
agent = create_agent(
model=ChatAnthropic(model="claude-sonnet-4-6"),
tools=NimbleToolkit(include_web_search_agents=True).get_tools(),
)
result = agent.invoke({"messages": [(
"user",
"Research the most important developments related to OpenAI from the past 30 days. Cover product launches, partnerships, leadership changes, legal or regulatory developments, and major competitive moves. Rank by significance and cite the evidence.",
)]})With a single request, Nimble managed planning, searching, site navigation, and synthesis, returning a decision-ready brief. Each claim included a confidence grade: 26 of 27 were rated high, and one was rated medium because it relied on a secondary source. The Agent API automates the process, delivering a structured, sourced brief without requiring query-by-query management.
Use Case 2: Breaking News and Situation Monitoring
Breaking events get reported in fragments across national news, local outlets, government sources, and company statements, often with conflicting details. The hard part is separating new information from repeats, reconciling discrepancies, and spotting when separate events get conflated. This use case builds an agent that groups reports by distinct development and returns a timeline of verified updates and open questions, first with Nimble's Search API and then with a Web Search Agent.
See the breaking-event-monitoring-agent we built here.
Monitoring with Nimble's Search API
When tracking a breaking event, the standard approach is to search for its name directly. For example, querying variations of "United Airlines system outage that grounded flights nationwide" retrieves reports from official, national, and local sources using deep retrieval, ensuring each result includes the full article rather than just a headline.
The query is the event itself, run with deep retrieval so each result carries the full article:
result = nimble.search(
query="United Airlines system outage grounded flights nationwide",
full_content=True,
)Here's a trimmed view of what came back:
[{
"title": "United Airlines grounds flights nationwide due to tech issues",
"url": "https://apnews.com/article/united-airlines-flights-grounded-08d0e4c76d2c7bc6e38cd767fcec3dc8",
"source": "wire service",
"description": "A technology issue prompted United Airlines to ground planes at major U.S. airports.",
"extracted_characters": 128730
}, {
"title": "United Airlines flights grounded nationwide for 30 minutes",
"url": "https://www.nbcnews.com/news/us-news/united-airlines-flights-grounded-nationwide-connectivity-issue-rcna233357",
"source": "national news",
"description": "All United Airlines flights were grounded due to a connectivity issue before the ground stop was lifted 30 minutes later.",
"extracted_characters": 9253
},The agent works through this by grouping reports around distinct developments, checking conflicting claims against primary sources like the status pages at faa.gov and united.com, and separating confirmed facts from unverified ones. The result is a timeline of verified updates for each incident, with a timestamp and source on every entry and a list of claims that remain unresolved.
Monitoring with Nimble's Agent API
Here, you give Nimble the entire objective at once. Instead of issuing multiple queries, you provide the Web Search Agent with a single instruction: build a current situation report on the United Airlines outage that grounded flights nationwide, explain the impacts, state what United and the FAA confirmed, flag disputed points, and separate distinct incidents. The agent then plans and conducts the investigation.
That whole run starts from one request:
from langchain.agents import create_agent
from langchain_nimble import NimbleToolkit
from langchain_anthropic import ChatAnthropic
agent = create_agent(
model=ChatAnthropic(model="claude-sonnet-4-6"),
tools=NimbleToolkit(include_web_search_agents=True).get_tools(),
)
result = agent.invoke({"messages": [(
"user",
"Build a current situation report on the United Airlines outage that grounded flights nationwide. Explain what happened and what was affected, state what United and the FAA confirmed, flag what remains disputed, and if reporting refers to more than one incident, distinguish them."
,)]})From that single objective, the agent did the disambiguation that makes this use case matter. It opened by establishing that "the United outage" is not one event but three:
Reporting on a single United Airlines "system outage that grounded flights nationwide" actually refers to three separate outages ... one major multi-hour event in August 2025, a brief second nationwide ground stop in September 2025, and a third, narrower check-in outage in July 2026 that did not trigger an FAA ground stop.
The agent ranked the three by impact: the August 2025 Unimatic failure as the primary event, the brief September 2025 connectivity ground stop as a lesser incident, and the July 2026 reservation-system outage, which never triggered a ground stop. It also explained why they're easy to conflate, since outlets cross-referenced them and called the September event the second in under two months.
Each incident got its own timeline, confirmed facts, and cited sources, with all 16 claims graded high confidence against primary sources. From a single objective, the agent turned conflicting headlines into a structured brief that raw search results alone can't produce.
Use Case 3: Supply Chain Disruption Monitoring
Supply chain teams track anything that can disrupt the movement, availability, or cost of goods, from port closures and strikes to severe weather, security incidents, and routing changes. Unlike a single breaking event, these disruptions happen at once across categories and regions, with information scattered across port authority notices, carrier advisories, and logistics trade press.
This use case builds an agent that monitors a trade lane, categorizes each disruption by type and severity, and returns a prioritized brief, first with the Search API and then with a Web Search Agent.
See the supply-chain-monitoring-agent we built here.
Monitoring with Nimble's Search API
Because disruptions fall into distinct categories, the search process uses multiple targeted queries, each focused on a specific disruption type for the monitored lane. For the Asia-to-Europe container lane, this involved separate queries for Red Sea and Suez rerouting, port congestion, and freight-rate changes, all executed with deep retrieval to ensure each result includes the full article.
Each disruption type is its own targeted query, run with deep retrieval:
result = nimble.search(
query="Red Sea Suez container diversion Cape of Good Hope carriers",
deep_search=True,
)This approach yields current, authoritative coverage from maritime and logistics trade press, which are primary sources for supply chain professionals. A representative sample across the three categories:
[
{
"category": "rerouting",
"title": "ME11 & MECL Rerouted via Cape of Good Hope",
"url": "https://www.maersk.com/news/articles/2026/03/01/me11-mecl-rerouting-cape-of-good-hope-march",
"source": "carrier advisory",
"extracted_characters": 7797
},
{
"category": "port congestion",
"title": "Port congestion in Asia pushes carriers back to Suez as ...",
"url": "https://www.hellenicshippingnews.com/port-congestion-in-asia-pushes-carriers-back-to-suez-as-peak-season-splits-across-trade-corridors/",
"source": "maritime trade press",
"extracted_characters": 31961
},The queries return carrier advisories and trade-press coverage, but ongoing disruptions like the Red Sea situation mix current news with months of background. The agent separates the two, tags each disruption by type, geography, severity, and affected lanes, drops any figure it can't source, and ranks the best-supported few into a prioritized brief.
Monitoring with Nimble's Agent API
Here, the entire objective is given to Nimble: monitor current events that could disrupt Asia-to-Europe container shipping, identify rerouting, congestion, freight-rate movement, and any labor, weather, or security disruptions. For each, state the type, geography, affected lanes, operational impact, and severity; rank them, cite every quantitative claim, and omit any figure that cannot be sourced.
That entire brief comes from one request:
from langchain.agents import create_agent
from langchain_nimble import NimbleToolkit
from langchain_anthropic import ChatAnthropic
agent = create_agent(
model=ChatAnthropic(model="claude-sonnet-4-6"),
tools=NimbleToolkit(include_web_search_agents=True).get_tools(),
)
result = agent.invoke({"messages": [(
"user",
"Monitor current events that could disrupt Asia-to-Europe container shipping: rerouting, congestion, freight-rate movement, and any labor, weather, or security disruptions. For each, state type, geography, affected lanes, operational impact, and severity. Rank by significance, cite every quantitative claim, and omit figures you cannot source.",
)]})The agent returned six ranked disruptions, each labeled by type, geography, and severity: carriers returning to Suez, typhoon congestion off East China, security risk in the Strait of Hormuz, renewed Houthi threats in the Bab el-Mandeb, declining schedule reliability, and drought cutting Rhine barge capacity.
Headline figures were attributed to their sources, like Drewry for the World Container Index, and all 19 claims were rated high confidence. Ongoing issues like the broader Houthi campaign went into a separate context section rather than being presented as new.
Where the Search API returned raw signals, the agent delivered a ranked, sourced brief that separates current disruptions from background.
Why Nimble Goes Deeper for News and Current Events Monitoring
Specialized retrieval that learns the use case
Generic search uses the same approach for every query. Nimble customizes retrieval for each use case and information need, helping identify better sources and extract deeper context. Web Search Agents also improve over time, learning which sources and methods consistently yield valuable information and providing more comprehensive context for recurring monitoring tasks.
Site navigation that goes beyond the results page
Most AI web tools submit a query to a search algorithm and accept the returned results. Web Search Agents go further by navigating high-value sites to access content not visible in standard results. As shown above, this approach enabled agents to retrieve carrier advisories and official status pages, rather than stopping at news summaries.
Reliable access to the underlying data
Nimble manages the retrieval infrastructure that developers would otherwise need to build and maintain, including JavaScript rendering, anti-bot and proxy handling, page interaction, and full-page extraction. This capability is especially important for monitoring, as relevant information is often found on company sites, local news, government portals, and trade publications beyond the first page of search results.
Full research orchestration
With the Agent API, Nimble manages the entire research process, not just individual retrieval steps. It determines the required scope, coordinates searches and extractions, navigates sites, synthesizes findings, and applies the output schema and confidence scoring as demonstrated above. This confidence grading ensures the output is actionable by indicating which findings are well-sourced and which require further review.
How to Get Started with Nimble's Search API and Web Search Agents
We suggest getting started by testing Nimble with your personal AI. Simply give it this link to get started.
To embed it into your AI workflows, choose the best option for you:
- See Nimble's integrations with the AI ecosystem including LangChain, LlamaIndex, liteLLM, and many more.
- Install the SDK for Python, Typescript, Go, or curl.
- Install the Nimble MCP Server.
Before you do any of these things, start a free trial.
FAQ
Answers to frequently asked questions

.webp)


.webp)
.webp)
.webp)
.avif)