The Wall Street Journal MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on The Wall Street Journal: 25 typed functions through one MCP server. No The Wall Street Journal API key needed.
- Site
- wsj.com
- Functions
- 25
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for The Wall Street Journal alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/wsjOne MCP server for The Wall Street Journal and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.
Functions
Open a function to see its arguments, what it returns and how to call it.
getArticleGets one article's own headline, byline, dek, section, publish date and body.Arguments
Name Type Required urlstringA url from listArticles or listSections.Yes Returns
WsjArticleinterface WsjArticle { headline: string; byline: string | null; // e.g. "Marcus Walker and Serhiy Bosak" dek: string | null; section: string | null; publishedAt: string | null; // ISO body: string[]; // the free preview when paywalled, the full article otherwise paywalled: boolean; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wsj/getArticleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wsj.getArticle({ url: "<url>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wsj.getArticle({"url": "<url>"}))curl -X POST https://api.bowmark.ai/v1/sites/wsj/getArticle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"url":"<url>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wsj.getArticle({ url: "<url>" });getArticleFullTextGets the full text of a subscriber-only article using the CALLER's own WSJ subscription.Arguments
Name Type Required urlstringA www.wsj.com article url; needs the caller's own WSJ subscription.Yes Returns
WsjArticleinterface WsjArticle { headline: string; byline: string | null; // e.g. "Marcus Walker and Serhiy Bosak" dek: string | null; section: string | null; publishedAt: string | null; // ISO body: string[]; // the free preview when paywalled, the full article otherwise paywalled: boolean; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wsj/getArticleFullTextCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wsj.getArticleFullText({ url: "<url>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wsj.getArticleFullText({"url": "<url>"}))curl -X POST https://api.bowmark.ai/v1/sites/wsj/getArticleFullText \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"url":"<url>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wsj.getArticleFullText({ url: "<url>" });getAuthorGets a WSJ journalist's own byline page (/news/author/<slug>).Arguments
Name Type Required seoNamestringA byline slug, e.g. "marcus-walker", or the author page url.Yes Returns
WsjAuthorinterface WsjAuthor { id: string | null; name: string; seoName: string; // e.g. "marcus-walker", pass to listArticlesByAuthor title: string | null; // e.g. "South Europe Bureau Chief" bio: string | null; // plain text organization: string | null; email: string | null; twitter: string | null; // handle, no "@" imageUrl: string | null; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wsj/getAuthorCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wsj.getAuthor({ seoName: "marcus-walker" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wsj.getAuthor({"seoName": "marcus-walker"}))curl -X POST https://api.bowmark.ai/v1/sites/wsj/getAuthor \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"seoName":"marcus-walker"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wsj.getAuthor({ seoName: "marcus-walker" });getNewsletterGets one WSJ newsletter's own catalog entry by seoName or id.Arguments
Name Type Required seoNamestringFrom listNewsletters, e.g. "whats-news", or its numeric id.Yes Returns
WsjNewsletterinterface WsjNewsletter { id: string; // e.g. "401" seoName: string; // e.g. "whats-news", pass to getNewsletter name: string; // e.g. "What’s News" description: string | null; cadence: string | null; // the site's own words, e.g. "Daily", "Tuesdays, Thursdays" subscribersOnly: boolean; // true when only a paying WSJ subscriber can sign up edition: string; // e.g. "us_gc" (US), "ko" (Korea) latestIssueUrl: string | null; // the site's own preview of a recent issue imageUrl: string | null; authorIds: string[]; // WSJ author ids of the newsletter's writers }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wsj/getNewsletterCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wsj.getNewsletter({ seoName: "<seoName>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wsj.getNewsletter({"seoName": "<seoName>"}))curl -X POST https://api.bowmark.ai/v1/sites/wsj/getNewsletter \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"seoName":"<seoName>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wsj.getNewsletter({ seoName: "<seoName>" });getPodcastGets one podcast's own catalog record by seoName.Arguments
Name Type Required seoNamestringFrom listPodcasts, e.g. "whats-news".Yes Returns
WsjPodcastDetailinterface WsjPodcastSubscribeLink { name: string; // e.g. "Apple Podcasts", "Spotify", "RSS" url: string; } interface WsjPodcast { name: string; // e.g. "What's News" seoName: string; // e.g. "whats-news", pass to listEpisodes/getPodcast description: string | null; category: string | null; // e.g. "News & Politics" author: string | null; url: string; subscribe: WsjPodcastSubscribeLink[]; } interface WsjPodcastDetail extends WsjPodcast { feedUrl: string | null; // the show's own RSS feed, null for the few sponsored shows that publish none imageUrl: string | null; episodeCount: number | null; lastEpisodeAt: string | null; // ISO }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wsj/getPodcastCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wsj.getPodcast({ seoName: "whats-news" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wsj.getPodcast({"seoName": "whats-news"}))curl -X POST https://api.bowmark.ai/v1/sites/wsj/getPodcast \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"seoName":"whats-news"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wsj.getPodcast({ seoName: "whats-news" });getQuoteGets one US-listed symbol's current quote.Arguments
Name Type Required symbolstringA stock ticker, e.g. "AAPL".Yes Returns
WsjQuoteinterface WsjQuote { symbol: string; // e.g. "AAPL" name: string; // e.g. "Apple Inc." exchange: string | null; // e.g. "U.S.: Nasdaq" price: number; change: number; // net change, same sign as the site's own display changePercent: number; // e.g. 0.93 for "+0.93%" open: number; high: number; low: number; volume: number | null; asOf: string | null; // ISO, off CompositeTrading.Last.Time }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wsj/getQuoteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wsj.getQuote({ symbol: "AAPL" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wsj.getQuote({"symbol": "AAPL"}))curl -X POST https://api.bowmark.ai/v1/sites/wsj/getQuote \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"symbol":"AAPL"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wsj.getQuote({ symbol: "AAPL" });getWatchlistGets the caller's own WSJ stock watchlist through their signed-in WSJ session.Arguments
None.
Returns
WsjMarketIndex[]interface WsjMarketIndex { name: string; // e.g. "Dow Jones Industrial Average" symbol: string; // e.g. "DJIA" price: number; change: number; // net change, same sign as the site's own display changePercent: number; // e.g. 0.59 for "+0.59%" }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wsj/getWatchlistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wsj.getWatchlist();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wsj.getWatchlist())curl -X POST https://api.bowmark.ai/v1/sites/wsj/getWatchlist \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wsj.getWatchlist();listArticlesLists a section front's own article grid, newest first, with headline, byline, teaser and url.Arguments
Name Type Required sectionstringA path from listSections, e.g. "/world" or "world".Yes Returns
WsjArticleSummary[]interface WsjArticleSummary { headline: string; byline: string | null; // e.g. "Erin Mulvaney, Cara Lombardo" teaser: string | null; url: string; // pass to getArticle }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wsj/listArticlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wsj.listArticles({ section: "/news/markets" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wsj.listArticles({"section": "/news/markets"}))curl -X POST https://api.bowmark.ai/v1/sites/wsj/listArticles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"section":"/news/markets"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wsj.listArticles({ section: "/news/markets" });listArticlesByAuthorLists a journalist's own articles off their byline page, newest first, 50 a page via page.Arguments
Name Type Required seoNamestringYes pagenumber1-based, 50 articles a page; default 1.No Returns
WsjAuthorArticle[]interface WsjAuthorArticle { headline: string; summary: string | null; section: string | null; // the flashline, e.g. "World" authors: string[]; publishedAt: string | null; // ISO isOpinion: boolean; imageUrl: string | null; url: string; // pass to getArticle }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wsj/listArticlesByAuthorCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wsj.listArticlesByAuthor({ seoName: "<seoName>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wsj.listArticlesByAuthor({"seoName": "<seoName>"}))curl -X POST https://api.bowmark.ai/v1/sites/wsj/listArticlesByAuthor \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"seoName":"<seoName>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wsj.listArticlesByAuthor({ seoName: "<seoName>" });listCommoditiesLists the commodity futures on WSJ's Commodities and Futures page.Arguments
None.
Returns
WsjMarketInstrument[]interface WsjMarketInstrument { name: string; // the table's label, e.g. "Crude Oil Futures", "Euro (EUR/USD)" fullName: string | null; // e.g. "Crude Oil WTI (NYM $/bbl) Front Month" symbol: string; // WSJ's ticker, e.g. "CL.1", "EURUSD" kind: string; // "Future" | "Currency" | "CryptoCurrency" price: number; change: number; changePercent: number; dailyHigh: number | null; dailyLow: number | null; timestamp: string | null; url: string | null; // the instrument's own WSJ quote page }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wsj/listCommoditiesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wsj.listCommodities();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wsj.listCommodities())curl -X POST https://api.bowmark.ai/v1/sites/wsj/listCommodities \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wsj.listCommodities();listCurrenciesLists exchange rates off WSJ's Currencies page.Arguments
None.
Returns
WsjMarketInstrument[]interface WsjMarketInstrument { name: string; // the table's label, e.g. "Crude Oil Futures", "Euro (EUR/USD)" fullName: string | null; // e.g. "Crude Oil WTI (NYM $/bbl) Front Month" symbol: string; // WSJ's ticker, e.g. "CL.1", "EURUSD" kind: string; // "Future" | "Currency" | "CryptoCurrency" price: number; change: number; changePercent: number; dailyHigh: number | null; dailyLow: number | null; timestamp: string | null; url: string | null; // the instrument's own WSJ quote page }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wsj/listCurrenciesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wsj.listCurrencies();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wsj.listCurrencies())curl -X POST https://api.bowmark.ai/v1/sites/wsj/listCurrencies \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wsj.listCurrencies();listEpisodesLists a podcast's own episodes, newest first, off the show's RSS feed on Dow Jones' podcast host.Arguments
Name Type Required seoNamestringFrom listPodcasts, e.g. "whats-news".Yes limitnumberDefault 50.No Returns
WsjEpisode[]interface WsjEpisode { id: string | null; // the feed's own guid title: string; description: string | null; // HTML, as the feed ships it publishedAt: string | null; // ISO duration: string | null; // e.g. "00:12:43" audioUrl: string | null; episodeNumber: number | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wsj/listEpisodesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wsj.listEpisodes({ seoName: "whats-news", limit: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wsj.listEpisodes({"seoName": "whats-news", "limit": 5}))curl -X POST https://api.bowmark.ai/v1/sites/wsj/listEpisodes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"seoName":"whats-news","limit":5}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wsj.listEpisodes({ seoName: "whats-news", limit: 5 });listMarketIndicesLists the major indices WSJ's own Markets front ships inline.Arguments
None.
Returns
WsjMarketIndex[]interface WsjMarketIndex { name: string; // e.g. "Dow Jones Industrial Average" symbol: string; // e.g. "DJIA" price: number; change: number; // net change, same sign as the site's own display changePercent: number; // e.g. 0.59 for "+0.59%" }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wsj/listMarketIndicesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wsj.listMarketIndices();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wsj.listMarketIndices())curl -X POST https://api.bowmark.ai/v1/sites/wsj/listMarketIndices \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wsj.listMarketIndices();listNewslettersLists WSJ's own email newsletters off its newsletter catalog.Arguments
None.
Returns
WsjNewsletter[]interface WsjNewsletter { id: string; // e.g. "401" seoName: string; // e.g. "whats-news", pass to getNewsletter name: string; // e.g. "What’s News" description: string | null; cadence: string | null; // the site's own words, e.g. "Daily", "Tuesdays, Thursdays" subscribersOnly: boolean; // true when only a paying WSJ subscriber can sign up edition: string; // e.g. "us_gc" (US), "ko" (Korea) latestIssueUrl: string | null; // the site's own preview of a recent issue imageUrl: string | null; authorIds: string[]; // WSJ author ids of the newsletter's writers }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wsj/listNewslettersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wsj.listNewsletters();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wsj.listNewsletters())curl -X POST https://api.bowmark.ai/v1/sites/wsj/listNewsletters \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wsj.listNewsletters();listPodcastsLists WSJ's own podcasts (What's News, The Journal, Minute Briefing, etc.) off the site's podcast catalog, with description, category and subscribe…Arguments
None.
Returns
WsjPodcast[]interface WsjPodcastSubscribeLink { name: string; // e.g. "Apple Podcasts", "Spotify", "RSS" url: string; } interface WsjPodcast { name: string; // e.g. "What's News" seoName: string; // e.g. "whats-news", pass to listEpisodes/getPodcast description: string | null; category: string | null; // e.g. "News & Politics" author: string | null; url: string; subscribe: WsjPodcastSubscribeLink[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wsj/listPodcastsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wsj.listPodcasts();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wsj.listPodcasts())curl -X POST https://api.bowmark.ai/v1/sites/wsj/listPodcasts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wsj.listPodcasts();listQuotesGets quotes for several US-listed symbols in one call.Arguments
Name Type Required symbolsstring[]Stock tickers, e.g. ["AAPL", "MSFT", "NVDA"].Yes Returns
WsjQuotesResultinterface WsjQuote { symbol: string; // e.g. "AAPL" name: string; // e.g. "Apple Inc." exchange: string | null; // e.g. "U.S.: Nasdaq" price: number; change: number; // net change, same sign as the site's own display changePercent: number; // e.g. 0.93 for "+0.93%" open: number; high: number; low: number; volume: number | null; asOf: string | null; // ISO, off CompositeTrading.Last.Time } interface WsjQuotesResult { quotes: WsjQuote[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wsj/listQuotesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wsj.listQuotes({ symbols: ["AAPL", "MSFT"] });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wsj.listQuotes({"symbols": ["AAPL", "MSFT"]}))curl -X POST https://api.bowmark.ai/v1/sites/wsj/listQuotes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"symbols":["AAPL","MSFT"]}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wsj.listQuotes({ symbols: ["AAPL", "MSFT"] });listSavedArticlesLists the articles the caller has saved to their own My WSJ account, through the CALLER's signed-in WSJ session.Arguments
None.
Returns
WsjArticleSummary[]interface WsjArticleSummary { headline: string; byline: string | null; // e.g. "Erin Mulvaney, Cara Lombardo" teaser: string | null; url: string; // pass to getArticle }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wsj/listSavedArticlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wsj.listSavedArticles();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wsj.listSavedArticles())curl -X POST https://api.bowmark.ai/v1/sites/wsj/listSavedArticles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wsj.listSavedArticles();listSectionsLists WSJ's own news sections and verticals (World, Business, Markets, Tech, Opinion, Life & Arts, Personal Finance, etc.) off the site's own…Arguments
None.
Returns
WsjSection[]interface WsjSection { name: string; // e.g. "World", "Personal Finance" path: string; // e.g. "/world", pass to listArticles url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wsj/listSectionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wsj.listSections();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wsj.listSections())curl -X POST https://api.bowmark.ai/v1/sites/wsj/listSections \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wsj.listSections();listTreasuryYieldsLists U.S. Treasury yields by maturity, 1-month bill to 30-year bond, off WSJ's Bonds and Rates page.Arguments
None.
Returns
WsjTreasuryYield[]interface WsjTreasuryYield { maturity: string; // "30-Year Bond", "10-Year Note", "3-Month Bill", … symbol: string; // e.g. "TMUBMUSD10Y" yieldPercent: number; // e.g. 5.04 yieldChange: number; // percentage points price: number | null; // trade price, e.g. 96.1 priceChange: string | null; // in 32nds as WSJ shows it, e.g. "-2/32" couponRate: number | null; timestamp: string | null; url: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wsj/listTreasuryYieldsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wsj.listTreasuryYields();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wsj.listTreasuryYields())curl -X POST https://api.bowmark.ai/v1/sites/wsj/listTreasuryYields \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wsj.listTreasuryYields();listTrendingLists WSJ's own Most Popular articles right now.Arguments
None.
Returns
WsjTrendingArticle[]interface WsjTrendingArticle { rank: number; // 1-based, within its list list: "news" | "opinion"; // "Most Popular News" or "Most Popular Opinion" headline: string; section: string | null; // the flashline, e.g. "Tech", "Review & Outlook" id: string | null; isBreaking: boolean; imageUrl: string | null; url: string; // pass to getArticle }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wsj/listTrendingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wsj.listTrending();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wsj.listTrending())curl -X POST https://api.bowmark.ai/v1/sites/wsj/listTrending \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wsj.listTrending();searchArticlesSearches WSJ's own site search for a keyword and returns matching articles with headline, byline, a publish timestamp and url.Arguments
Name Type Required querystringYes Returns
WsjSearchResult[]interface WsjSearchResult { headline: string; byline: string | null; // e.g. "Patrick George" teaser: string | null; publishedAt: string | null; // the site's own timestamp string, relative or absolute url: string; // pass to getArticle }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wsj/searchArticlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wsj.searchArticles({ query: "markets" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wsj.searchArticles({"query": "markets"}))curl -X POST https://api.bowmark.ai/v1/sites/wsj/searchArticles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"markets"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wsj.searchArticles({ query: "markets" });
addToWatchlistAdds a stock to the caller's own WSJ watchlist through their signed-in WSJ session, by pressing the symbol quote page's own watchlist control.Arguments
Name Type Required symbolstringA stock ticker, e.g. "AAPL".Yes Returns
WsjWatchlistWriteResultinterface WsjWatchlistWriteResult { symbol: string; watching: boolean; // whether the symbol is on the caller's watchlist after the call changed: boolean; // false when it was already in that state }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wsj/addToWatchlistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wsj.addToWatchlist({ symbol: "<symbol>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wsj.addToWatchlist({"symbol": "<symbol>"}))curl -X POST https://api.bowmark.ai/v1/sites/wsj/addToWatchlist \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"symbol":"<symbol>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wsj.addToWatchlist({ symbol: "<symbol>" });removeFromWatchlistRemoves a stock from the caller's own WSJ watchlist through their signed-in WSJ session, by pressing the symbol quote page's own watchlist control.Arguments
Name Type Required symbolstringA stock ticker, e.g. "AAPL".Yes Returns
WsjWatchlistWriteResultinterface WsjWatchlistWriteResult { symbol: string; watching: boolean; // whether the symbol is on the caller's watchlist after the call changed: boolean; // false when it was already in that state }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wsj/removeFromWatchlistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wsj.removeFromWatchlist({ symbol: "<symbol>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wsj.removeFromWatchlist({"symbol": "<symbol>"}))curl -X POST https://api.bowmark.ai/v1/sites/wsj/removeFromWatchlist \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"symbol":"<symbol>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wsj.removeFromWatchlist({ symbol: "<symbol>" });saveArticleSaves an article to the caller's own My WSJ saved list, through their signed-in WSJ session, by pressing the article page's own save control.Arguments
Name Type Required urlstringA www.wsj.com article url, e.g. from listArticles or listSavedArticles.Yes Returns
WsjSaveResultinterface WsjSaveResult { url: string; saved: boolean; // the article's state on the caller's saved list after the call changed: boolean; // false when it was already in that state }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wsj/saveArticleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wsj.saveArticle({ url: "<url>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wsj.saveArticle({"url": "<url>"}))curl -X POST https://api.bowmark.ai/v1/sites/wsj/saveArticle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"url":"<url>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wsj.saveArticle({ url: "<url>" });unsaveArticleRemoves an article from the caller's own My WSJ saved list, through their signed-in WSJ session, by pressing the article page's own save control.Arguments
Name Type Required urlstringA www.wsj.com article url, e.g. from listArticles or listSavedArticles.Yes Returns
WsjSaveResultinterface WsjSaveResult { url: string; saved: boolean; // the article's state on the caller's saved list after the call changed: boolean; // false when it was already in that state }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wsj/unsaveArticleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wsj.unsaveArticle({ url: "<url>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wsj.unsaveArticle({"url": "<url>"}))curl -X POST https://api.bowmark.ai/v1/sites/wsj/unsaveArticle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"url":"<url>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wsj.unsaveArticle({ url: "<url>" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/wsj/<function> - OpenAPI
/v1/sites/wsj/openapi.json