Skip to main content Home Creators comeonoliver skillshub exa-webhooks-events
exa-webhooks-events Build event-driven integrations with Exa using scheduled monitors and content alerts.
Use when building content monitoring, competitive intelligence pipelines,
or scheduled search automation with Exa.
Trigger with phrases like "exa monitor", "exa content alerts",
"exa scheduled search", "exa event-driven", "exa notifications".
Jump to install Skills Marketplace Discover and explore AI skills built by the community.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Show prompt details A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/ComeOnOliver/skillshub --skill exa-webhooks-eventsThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Download Zip Downloading... More from this repository Review product and feature risk before an AI coding agent starts implementation.
Use Xquik for X data and confirmation-gated X actions: tweet search, user lookup, follower export, media download, monitors, webhooks, MCP, and SDK workflows.
Canton Network open-source ecosystem guide covering DAML SDK, Canton runtime, and Splice applications. Use when working with Canton Network, DAML smart contracts, or building decentralized applications.
Related occupations SOC
Based on SOC occupation classification
name exa-webhooks-events description Build event-driven integrations with Exa using scheduled monitors and content alerts.
Use when building content monitoring, competitive intelligence pipelines,
or scheduled search automation with Exa.
Trigger with phrases like "exa monitor", "exa content alerts",
"exa scheduled search", "exa event-driven", "exa notifications".
allowed-tools Read, Write, Edit, Bash(curl:*), Bash(node:*) version 1.0.0 license MIT author Jeremy Longshore <jeremy@intentsolutions.io> compatible-with claude-code, codex, openclaw tags ["saas","exa","webhooks","monitoring","automation"]
Exa Webhooks & Events
Overview
Build event-driven integrations around Exa neural search. Exa is a synchronous search API (no native webhooks), so this skill covers building async patterns: scheduled content monitoring with searchAndContents, similarity alerts with findSimilarAndContents, new content detection using date filters, and webhook-style notification delivery.
Prerequisites
exa-js installed and EXA_API_KEY configuredQueue system (BullMQ/Redis) or cron scheduler
Webhook endpoint for notifications
Event Patterns
Pattern Mechanism Use Case Content monitor Scheduled searchAndContents with startPublishedDate New article alerts Similarity alert Periodic findSimilarAndContents + diff Competitive monitoring Content change Re-search + compare result sets Update tracking Research digest Scheduled answer + email/Slack Daily briefings
Instructions
Step 1: Content Monitor Service
import Exa from "exa-js" ;
import { Queue , Worker } from "bullmq" ;
const exa = new Exa (process.env .EXA_API_KEY !);
interface SearchMonitor {
id : string ;
query : string ;
webhookUrl : string ;
lastResultUrls : Set
string
intervalMinutes
number
searchType
"auto"
"neural"
"keyword"
const
new
Queue
"exa-monitors"
connection
host
"localhost"
port
6379
async
function
createMonitor
config : Omit <SearchMonitor , "lastResultUrls" >
await
add
"check-search"
repeat
every
intervalMinutes
60
1000
jobId
id
console
log
`Monitor created: ${config.id} (every ${config.intervalMinutes} min)`
Step 2: Execute Monitored Searches const worker = new Worker ("exa-monitors" , async (job) => {
const monitor = job.data ;
const results = await exa.searchAndContents (monitor.query , {
type : monitor.searchType || "auto" ,
numResults : 10 ,
text : { maxCharacters : 500 },
highlights : { maxCharacters : 300 , query : monitor.query },
startPublishedDate : getLastCheckDate (monitor.id ),
});
const newResults = results.results .filter (
r =>lastResultUrls ?.has (r.url )
);
if (newResults.length > 0 ) {
await sendWebhook (monitor.webhookUrl , {
event : "exa.new_results" ,
monitorId : monitor.id ,
query : monitor.query ,
timestamp : new Date ().toISOString (),
results : newResults.map (r =>title : r.title ,
url : r.url ,
snippet : r.text ?.substring (0 , 200 ),
highlights : r.highlights ,
publishedDate : r.publishedDate ,
score : r.score ,
})),
});
await updateLastResultUrls (monitor.id , newResults.map (r =>url ));
}
}, { connection : { host : "localhost" , port : 6379 } });
Step 3: Similarity Alert System async function monitorSimilarContent (
seedUrl : string ,
webhookUrl : string ,
checkIntervalHours = 24
) {
const results = await exa.findSimilarAndContents (seedUrl, {
numResults : 5 ,
text : { maxCharacters : 300 },
excludeSourceDomain : true ,
startPublishedDate : new Date (
Date .now () - checkIntervalHours * 60 * 60 * 1000
).toISOString (),
});
if (results.results .length > 0 ) {
await sendWebhook (webhookUrl, {
event : "exa.similar_content_found" ,
seedUrl,
matchCount : results.results .length ,
matches : results.results .map (r =>title : r.title ,
url : r.url ,
snippet : r.text ?.substring (0 , 200 ),
score : r.score ,
})),
});
}
return results.results .length ;
}
Step 4: Webhook Delivery with Retry async function sendWebhook (url : string , payload : any , maxRetries = 3 for (let attempt = 0 ; attempt < maxRetries; attempt++) {
try {
const response = await fetch (url, {
method : "POST" ,
headers : {
"Content-Type" : "application/json" ,
"X-Exa-Event" : payload.event ,
},
body : JSON .stringify (payload),
});
if (response.ok ) return ;
console .warn (`Webhook ${response.status} : ${url} ` );
} catch (error) {
if (attempt === maxRetries - 1 ) throw error;
}
await new Promise (r =>setTimeout (r, 1000 * Math .pow (2 , attempt)));
}
}
Step 5: Daily Research Digest async function generateDailyDigest (
topics : string [],
webhookUrl : string
) {
const digest = [];
for (const topic of topics) {
const results = await exa.searchAndContents (topic, {
type : "neural" ,
numResults : 3 ,
summary : { query : `Latest developments in: ${topic} ` },
startPublishedDate : new Date (
Date .now () - 24 * 60 * 60 * 1000
).toISOString (),
});
digest.push ({
topic,
articles : results.results .map (r =>title : r.title ,
url : r.url ,
summary : r.summary ,
})),
});
}
await sendWebhook (webhookUrl, {
event : "exa.daily_digest" ,
date : new Date ().toISOString ().split ("T" )[0 ],
topics : digest,
});
}
Error Handling Issue Cause Solution Rate limited monitors Too many concurrent checks Stagger monitor intervals Empty results Date filter too narrow Widen to 48-hour windows Duplicate alerts Missing URL dedup Track result URLs between runs Webhook delivery fails Endpoint down Retry with exponential backoff
Examples
Create a Competitive Intelligence Monitor await createMonitor ({
id : "competitor-watch" ,
query : "AI code review tools launch announcement" ,
webhookUrl : "https://api.myapp.com/webhooks/exa-alerts" ,
intervalMinutes : 60 ,
searchType : "neural" ,
});
Resources
Next Steps For deployment setup, see exa-deploy-integration.
