Real-Time Use Cases
The following real-time cookbooks demonstrate how to use Dappier tools inside AgentStack to build fully local, multi-agent workflows. Each example includes project initialization, agent and task setup, tool configuration, and runtime execution with OpenAI and AgentOps integration.-
Dynamic Travel Planner
Generate a travel itinerary for a selected city and date, using Dappier’s real-time web search tool. The system retrieves current weather, live events, and hotel deals, then compiles a structured markdown itinerary with daily activity suggestions and booking links. -
Stock Market Researcher
Build an end-to-end research agent that analyzes public companies using real-time web and financial data. This workflow combines company overviews, financial metrics, peer benchmarking, live stock performance, and categorized financial news into a single markdown investment report.
Overview
The AgentStack integration with Dappier allows developers to enhance their agent workflows with real-time search and AI-powered content recommendation tools. By connecting to Dappier’s pre-trained, rights-cleared APIs, agents built with AgentStack can retrieve up-to-date information across domains such as news, weather, finance, sports, pet care, sustainable living, and local events. This integration includes access to the following tools:- real_time_web_search: Perform real-time web queries across general domains including news, weather, events, and more.
- stock_market_data_search: Retrieve live financial news and stock-specific insights.
- get_sports_news: Access real-time sports news and analysis from top media sources.
- get_lifestyle_news: Retrieve lifestyle content recommendations from trusted lifestyle publications.
- get_iheartdogs_content: Surface dog care, behavior, and health tips from iHeartDogs.
- get_iheartcats_content: Fetch cat care guidance and lifestyle content from iHeartCats.
- get_greenmonster_guides: Recommend sustainable living content and eco-conscious guides.
- get_wishtv_news: Access local and national news, sports, entertainment, and multicultural headlines from WISH-TV.
Usage with AgentStack
To use Dappier tools inside your AgentStack project, you’ll first need to initialize a new project and then add the Dappier toolset using the CLI.Step 1: Initialize an AgentStack Project
Run the following command to scaffold a new project:Step 2: Add the Dappier Tool
To add Dappier tools to your project, run:- Automatically install the
dappierPython package (if not already installed) - Add Dappier’s toolset to your project configuration
- Make the tools available for use inside your agents via the
agentstack.tools["dappier"]registry
real_time_web_search or get_sports_news to individual agents using helper functions inside crew.py.
Available Tools
After runningagentstack tools add dappier, the following tools become available in your project. These tools can be selectively assigned to agents and used to perform real-time searches or content recommendations across various domains.
Real-Time Search Tools
These tools allow agents to access live data from the public web and financial markets using natural language queries. They return formatted summaries of current results pulled from trusted sources.real_time_web_search
Perform a real-time web search across a variety of domains such as news, weather, events, travel, and general updates.Use case: Dynamic content retrieval when no stock symbol is required.
Parameters
-
A natural language query describing the information to retrieve.query(str)
Required
Example:"What are the top tourist attractions in Rome today?"
Output
Returns a formatted string containing real-time search results from the public web, including summaries, source references, and context.stock_market_data_search
Retrieve real-time financial news, stock prices, earnings data, and sentiment-tagged insights. This tool is optimized for use with stock ticker symbols.Use case: Live stock analysis and financial market updates.
Parameters
-
A natural language query including a stock ticker or financial topic.query(str)
Required
Example:"Show me the latest earnings and performance of AAPL"
Output
Returns a formatted string summarizing stock-specific financial data, including price movements, valuation metrics, and financial news headlines.These tools are available after running
agentstack tools add dappier and can be imported from agentstack.tools["dappier"] for use inside your agents via crew.py.
AI-Powered Recommendation Tools
These tools return high-quality, curated article recommendations using AI-powered retrieval across vertical-specific sources. Each tool accepts a natural language query and supports additional options for tuning the result relevance, domain focus, and retrieval strategy.get_sports_news
Get sports news from trusted sources like Sportsnaut, Ringside Intel, LAFB Network, and others.Use case: Live sports updates, analysis, and highlights.
Parameters
-
A natural language query for sports-related content.query(str)
Required -
Number of top articles to return.similarity_top_k(int)
Default:9 -
Optional domain to prioritize.ref(str)
Example:"sportsnaut.com" -
Minimum number of articles from the reference domain.num_articles_ref(int) -
Retrieval method:search_algorithm(str)"most_recent","semantic","most_recent_semantic","trending"
Default:"most_recent"
Output
A formatted string of sports article headlines, summaries, and links.get_lifestyle_news
Access lifestyle stories and trends from The Mix, Nerdable, Snipdaily, Familyproof, and more.Use case: Style, wellness, culture, and lifestyle journalism.
Parameters
Same asget_sports_news.
Output
A formatted list of lifestyle article titles, summaries, and domains.get_iheartdogs_content
Fetch pet care content from iHeartDogs.com covering health, training, grooming, and behavior.Use case: Dog ownership support and informational content.
Parameters
Same asget_sports_news.
Output
A formatted string with dog-related article recommendations and links.get_iheartcats_content
Access curated cat care resources from iHeartCats.com.Use case: Feline health, enrichment, and daily care articles.
Parameters
Same asget_sports_news.
Output
A formatted string of recommended articles tailored to cat care topics.get_greenmonster_guides
Get sustainable living tips and eco-conscious articles from GreenMonster.Use case: Conscious consumerism, environmental awareness, and lifestyle.
Parameters
Same asget_sports_news.
Output
A list of articles related to green living, with descriptions and source references.get_wishtv_news
Fetch localized and national headlines from WISH-TV including breaking news, sports, politics, and multicultural stories.Use case: Hyperlocal news delivery and trending updates.
Parameters
Same asget_sports_news.
Output
A formatted feed of news article summaries and sources from the WISH-TV network.These tools are available after running
agentstack tools add dappier and can be imported from agentstack.tools["dappier"] for use inside your agents via crew.py.

