Add Octen plugin — web search, multi-query research, and content extraction - #150
Open
dongxu0413 wants to merge 6 commits into
Open
Add Octen plugin — web search, multi-query research, and content extraction#150dongxu0413 wants to merge 6 commits into
dongxu0413 wants to merge 6 commits into
Conversation
Update the octen source pin to 825363e (octen-grok-plugin with octen-mcp@0.3.6 and OCTEN_ENABLE_BETA_TOOLS=false), so the plugin exposes only the four generally-available tools. Drop the "Beta image/video search" clause from the catalog description and regenerate the plugin index. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Author
|
Hi @ykeremy — requesting review when you have a moment. This adds the official
Happy to rebase or adjust keywords/description on request. Thanks! |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this PR does
Adds the official Octen plugin to the Grok Build Plugin Marketplace. Supersedes #149.
octenhttps://github.com/Octen-Team/octen-grok-plugin.git@825363e074f6aa835368ab8358ff6be9fa050f1fWhy another search plugin
The catalog already has good semantic-search and scraping options. Octen is here for a different
axis: latency and retrieval width, which is what a coding agent actually spends its budget on.
Hard) — inside the budget to call search several times within a single agent turn.
SimpleQA and FreshQA through the official graders, plus a blind, position-debiased pairwise judge that
reports the per-competitor gaps, including where competitors beat us. Octen scores 95.2% on SimpleQA
and 55.8% on FreshQA there; scores and per-set latency all regenerate from run artifacts:
https://github.com/Octen-Team/search-eval
broad_searchis a server-side primitive, not a client loop. Give it the user's full question andOcten decomposes it into concurrent sub-queries, returning results grouped per sub-query. Every other
search plugin in this catalog makes the agent plan the fan-out itself, which costs extra turns and
extra tokens before a single result comes back. One
broad_searchcall replaces aplan-then-N-searches round trip.
categoryand apage_structuretypology, so a skill can distinguish docs from forum from product page without asecond model call.
Tools
searchnews_searchbroad_searchextractThe plugin includes the
octen-webskill, which picks the smallest tool that fits therequest and preserves returned source URLs.
Credentials
Octen uses a stdio MCP server with an
OCTEN_API_KEYread from the user's local environment.Unlike a hosted MCP server, no request is proxied through a third party — the key and the query go
from the user's machine straight to
api.octen.ai.Sign up at https://octen.ai to get an API key; new accounts start with $5 in free credit.
A hosted MCP server with browser OAuth is on our roadmap.
Ownership
The plugin source is maintained at https://github.com/Octen-Team/octen-grok-plugin under the official
Octen-Teamorganization, licensed MIT. I'm an engineer at Octen.Checklist
.grok-plugin/marketplace.jsonwith a unique, kebab-case name..grok-plugin/plugin-index.json.python3 scripts/validate-catalog.pypasses locally.python3 scripts/generate-plugin-index.py --checkpasses locally.Catalog diff is limited to the single
octenentry — no formatting or unrelated changes to otherentries in
marketplace.json, andplugin-index.jsondiffers only by the regeneratedoctenblock.Keywords are brand-scoped so the plugin CTA doesn't fire on generic search or extract requests:
Security
curl | bash, postinstall hook, remote-binary download/execute,eval, obfuscation, orminified payload.
.envfiles, SSH material, tokens, or unrelated environmentvariables.
octen, exposing exactly the four tools listed above(Beta
image_search/video_searchare disabled viaOCTEN_ENABLE_BETA_TOOLS=false).https://api.octen.ai— the only host the plugin contacts.OCTEN_API_KEY, supplied by the user from their local environment. No key isembedded in the repository, the marketplace entry, or the plugin documentation.
Validation
Notes for reviewers
Verified against the pinned build (
825363e): the plugin's MCP command —npx -y octen-mcp@0.3.6withOCTEN_ENABLE_BETA_TOOLS=false— completes the MCPinitializehandshake and lists exactly the four tools above; no Beta tool is exposed. Catalog and index
validators pass locally (see Validation).
To verify against this PR directly, point xAI Official at the merge ref in
~/.grok/config.toml:then refresh
/marketplacesand confirm theoctenMCP server and theocten-webskillappear and resolve. Happy to rebase or adjust keywords and description on request.
cc @ykeremy