How to Use Bilibili video search in Codex
Returns keyword matches with video links, uploaders, publication dates and engagement counts. Use it to discover videos across Bilibili before checking individual records.
Prompts to try with Bilibili video search in Codex
Copy an example into Codex, or ask in your own words.
Use Bilibili video search to look this up and give me the result as a table. Save the result in ./assets.
Pull the latest numbers from Bilibili video search and tell me what changed since last week.
Check Bilibili video search and summarize what you find in three bullet points.
Pull the newest data from Bilibili video search and give me the result as a table.
Check Bilibili video search every morning and tell me only when something changed.
How to set up Bilibili video search in Codex
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
codex mcp add spiral --url https://api.spiral.ai/mcp
- Sign in
Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.
codex mcp login spiral
Use the Spiral skill
- Send Codex 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 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 Bilibili video 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": "alexandria", "model": "bilibili-com/videos/search_videos", "input": { "keyword": "<keyword>" } }'
Then paste one of the prompts above: Codex finds Bilibili video search on Spiral, shows the price and runs it.
Bilibili video search providers and prices
Spiral runs Bilibili video search through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Codex for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Page | 1 to 50 | 1 | 1-based page; the site serves at most 1000 hits in total. |
| Tids | a number from 1 | Restrict to a partition id (30 = VOCALOID·UTAU, 3 = music, 193 = MV). Omit for all. | |
| Order | totalrank, click, pubdate, dm, or stow | totalrank | Sort: totalrank (relevance, default), click (plays), pubdate (newest), dm (danmaku), stow (favourites). |
| Page size | 1 to 50 | 20 | Hits per page, 1 to 50 (the site itself uses 42). |
Every API field of Bilibili · Search videos is on its tool page: open its card above.
What can you do with Bilibili video search in Codex?
Build a research panel for Bilibili music releases or Chinese-language tutorials. Have the coding agent turn retrieved Bilibili results into searchable records and review screens in your project.
Prepare a music release brief
Expand a song's search wording, identify the public artist account, inspect its profile and uploads, and find related videos. Verify the selected video records and summarize recurring questions in their comments.
Check attribution in a music catalog
Try original-language song names, resolve creator accounts, and compare their profiles and upload archives with keyword matches. Verify a saved list of video IDs before assigning creator credit in a catalog.
Curate a Chinese-language tutorial collection
Expand topic keywords, find public educational creators, and review their profiles and upload catalogs. Check selected videos for titles, duration and publication dates, then use viewer questions to identify prerequisites worth explaining.
Compare product announcements with public reviews
Expand a product's Chinese search terms, identify business and public reviewer accounts, and inspect their profiles and uploads. Verify announcement and review videos, compare their engagement counts, and summarize questions appearing in the comments.
Prepare an authorized translation review
Find a candidate video, check the public creator profile and video description for attribution, and obtain temporary playback URLs for a permitted language review.
More on Bilibili video search and Codex
Overview
Bilibili video search in other agents
Questions about Bilibili video search in Codex
Can Codex use Bilibili video search?
Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Bilibili video search like any built-in tool.
How much does Bilibili video search cost in Codex?
$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.
Do I need an Alexandria account to use Bilibili video search in Codex?
No. Spiral runs Bilibili video search on its own Alexandria account. You sign in to Spiral once and never paste a key.
How long does it take to set up Bilibili video search in Codex?
About two minutes: add the hosted server, then sign in.
Does Codex wait while Bilibili video search runs?
Bilibili video search runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.
What Bilibili content does this data cover?
The documented coverage is public bilibili.com video data: uploader profiles and archives, video metadata, comments and temporary DASH playback links.
Can Bilibili search return every matching video?
Bilibili serves at most 1,000 hits for a video query. A broad search cannot establish the full number of matching videos across the site.
Which languages can Bilibili autocomplete help with?
The web autocomplete documentation includes Chinese, English and Japanese, plus suggestions from full Chinese pinyin. It describes a maximum of 10 candidate keywords.
Do video records distinguish publication time from retrieval time?
The documented video detail response includes a publication timestamp and a separate observation timestamp. The publication date describes the upload, while the observation timestamp identifies when its data was observed.
Start using Bilibili video search in Codex
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Codex:
set up https://spiral.ai/SKILL.md


