How to Use Facebook event search in Hermes
Find public Facebook events by name, with dates, places, links, and public interested and going counts. Use it to find a named festival or topic when browsing a city's listings would be too broad.
Prompts to try with Facebook event search in Hermes
Copy an example into Hermes, or ask in your own words.
Each morning, use Facebook event search for 'Frankenmuth Dog Bowl' and report newly returned event links or changed dates.
Every Friday, use Facebook event search for 'jazz Chicago' and draft a brief of matching upcoming listings with dates and places.
Each week, use Facebook event search for 'DockDogs' and report changes to the dates and places of previously returned listings.
Every Monday at 9am: scrape https://example.com/pricing with Facebook event search and turn it into a comparison table.
Crawl the docs at https://docs.example.com with Facebook event search and summarize each section.
How to set up Facebook event search in Hermes
Pick the way that suits you. Each takes about two minutes.
Use the Spiral skill
- Send Hermes this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use Spiral's MCP server
- Add the server and sign in
Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.
hermes mcp add spiral \ --url https://api.spiral.ai/mcp \ --auth oauth \ --connect-timeout 300
- Check it
In a chat that was already open, run /reload-mcp.
hermes mcp list hermes mcp test spiral
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Facebook event search
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "scrapecreators", "model": "scrapecreators/facebook-events-search", "input": { "query": "Event name or description" } }'
Then paste one of the prompts above: Hermes finds Facebook event search on Spiral, shows the price and runs it.
Facebook event search providers and prices
Spiral runs Facebook event search through ScrapeCreators. Open a card for today's price, with every fee included.
What can you do with Facebook event search in Hermes?
Produce a recurring brief of Facebook event listings and changes in public responses. An agent running on a schedule can compare returned dates and places with its earlier observations.
Local events newsletter
Shortlist public events by date and venue, then prepare a newsletter draft with links to the Facebook listings.
Hotel guest activity brief
Prepare nearby event suggestions with names, dates, places, and source links for a hotel's front desk.
Venue scheduling research
Compare returned event dates and places before choosing a date for a public concert, market, or workshop.
Public event response comparison
Compare interested and going totals across relevant listings to help prioritize events for editorial review.
Event listing change report
Compare repeated results by event URL and flag changed dates, places, or public response totals.
Community calendar research
Collect event candidates, remove duplicate URLs, and organize names, dates, and venues for a calendar editor.
More on Facebook event search and Hermes
Overview
Facebook event search in other agents
Questions about Facebook event search in Hermes
Can Hermes use Facebook event search?
Yes. Add Spiral to Hermes as an MCP server, and Hermes can find and run Facebook event search like any built-in tool.
How much does Facebook event search cost in Hermes?
$0.0013 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Hermes plan is separate.
Do I need a ScrapeCreators account to use Facebook event search in Hermes?
No. Spiral runs Facebook event search on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.
How long does it take to set up Facebook event search in Hermes?
About two minutes: add the server and sign in, then check it.
Does Hermes wait while Facebook event search runs?
Facebook event search runs in the background. Hermes starts the run, checks on it and gives you the json when it's ready.
What Facebook events does this data cover?
The discovery sources are Facebook's city Events pages and public event search. These listings are a source for public event discovery, not evidence of access to private events.
How fresh are the event listings?
ScrapeCreators says it fetches the latest available Facebook Events information when a request is made. It describes request-time retrieval rather than a daily or weekly dataset update.
Will the results include every event in a city?
Do not assume complete coverage. ScrapeCreators notes that logged-out visibility can differ by location and recommendation order can change between sessions.
Can I retrieve more than the first results page?
Yes. Both city listings and event search support pagination, so the first response need not contain all available results.
Are the interested and going totals exact?
Do not assume every total has single-person precision. The documented city example converts Facebook's '7.3K interested' display to 7300, while reporting 195 going separately.
Start using Facebook event search in Hermes
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Hermes:
set up https://spiral.ai/SKILL.md


