Skip to content

puppyone-ai/puppyone-goggles

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 

Repository files navigation

puppyone Brave Goggles

Public Brave Search Goggles maintained by the puppyone team.

A Goggle is a plain-text re-ranking filter that anyone can apply on Brave Search to surface higher-signal content for a topic. Brave's submission pipeline only accepts Goggles hosted on public GitHub or GitLab repositories — which is why these files live in this dedicated public repo, separate from our (private) product source.

Available Goggles

File Description Apply on Brave
ai-agent-infrastructure.goggle Boosts authoritative sources on AI agents, MCP, RAG, agent frameworks (LangChain, LlamaIndex, CrewAI, AutoGen), coding agents (Cursor, Cline, Claude Code, Devin), and high-signal individual writers. Downranks SEO content farms; discards software-review aggregators. Apply

Applying a Goggle

Either:

  • Click the Apply link in the table above, or

  • Build the URL manually:

    https://search.brave.com/goggles?goggles_id=<url-encoded raw URL>
    

Once applied, Brave Search shows "Re-ranked with <Goggle name>" under the search box.

Publishing or updating a Goggle (maintainers)

  1. Edit the .goggle file in this repo (PR welcome).

  2. Merge to main. The raw URL is stable across edits.

  3. If this is a brand-new Goggle, register it on Brave once:

    • Go to https://search.brave.com/goggles/create
    • Paste the raw URL, e.g. https://raw.githubusercontent.com/puppyone-ai/puppyone-goggles/main/ai-agent-infrastructure.goggle
    • Submit. Brave fetches, validates and caches the file.
  4. For subsequent edits, re-submit the same URL on the same page to force Brave to refresh its cache (Brave does not auto-poll the source).

Syntax cheat sheet

! Comments start with "!"
! ─── Mandatory metadata header ──────────────────────────────────────────────
! name: ...
! description: ...
! public: true | false
! author: ...

! ─── Patterns ───────────────────────────────────────────────────────────────
/some/path/                          ! matches anywhere in URL
|https://example.com^                ! prefix anchor + URL boundary
/foo.js^                             ! caret = / | ? | & | end-of-url
*                                    ! wildcard (max 2 per instruction)

! ─── Options (after $, comma-separated) ─────────────────────────────────────
$site=example.com                    ! only this domain
$boost=N                             ! N from 1..10 (default action)
$downrank=N
$discard                             ! highest precedence

! ─── Examples ───────────────────────────────────────────────────────────────
$boost=3,site=anthropic.com          ! whole site, strong boost
/blog/$boost=2,site=langchain.com    ! only /blog/ paths on langchain.com
$discard,site=g2.com                 ! never show g2.com

Limits per Goggle file: 2 MB total, 100,000 instructions, 500 chars per instruction, 2 wildcards (*) per instruction, 2 carets (^) per instruction.

Full spec: https://github.com/brave/goggles-quickstart

Contributing

Found a low-signal site that should be downranked, or a high-signal source worth boosting? Open a PR. After merge, a maintainer re-submits the raw URL to Brave to refresh the cache.

License

MIT — copy, adapt, fork freely.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors