DEDUPED Hot AI repos, turned into use cases Get the Monday 5
74 stars · TypeScript

How to use Botscent: what you can do with it

What is Botscent? Botscent is a small open-source TypeScript and Python library that tells a site whether an AI agent, not a person, is browsing it and which agent it is.

How do I use it? Run npm install botscent in the project, or pip install botscent for a Python server; then add the page half for your framework, following the Quickstart section for that framework; add the server half, for example app.use(botscent()) in Express, or export { proxy } from 'botscent/next' in Next.js 16 or later. Full steps below.

Trended earlier

View repo on GitHub

Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer

Authorization notice. This tool is dual-use. Only use it on software, sites and systems you own or have explicit permission to test, and follow the relevant licenses and terms of service.

What do you want to do?

4 use cases

  • Log which AI agents visit your site

    Count visits by agent name so you can see agent traffic apart from people.

    View prompt
    Using the botscent repo (nalinbhardwaj/botscent), add agent visit logging to <site path>. Expected output: one log line per request with agent_name or human and the reasons. Verify that `npx botscent check https://<your-site>/` reports pass for both halves.

  • Let only verified AI agents through

    Use Web Bot Auth verification so access decisions rely on signed requests, not names.

    View prompt
    Using the botscent repo (nalinbhardwaj/botscent), gate <route path> so only requests where isVerified(own, '<agent name>') is true get through. Expected output: verified requests pass and unsigned requests are refused. Verify with `npx botscent check https://<your-site>/` that the server half reports pass.

  • Change page content when an AI agent visits

    Hide ads, simplify layout or adjust prices for agent visitors in the page itself.

    View prompt
    Using the botscent repo (nalinbhardwaj/botscent), change <component path> to hide ads when useBotscent() returns type agent. Expected output: the normal page for humans and a simplified page when the page verdict is agent. Verify with `npx botscent check https://<your-site>/` that the page half reports pass.

  • Check that Botscent is installed correctly

    Run one check against a live site to confirm both halves and the project setup work.

    View prompt
    Using the botscent repo (nalinbhardwaj/botscent), run `npx botscent check https://<your-site>/` in the project. Expected output: pass, fail, unknown or skipped for each check. Verify that the exit code is 0 and list the files you changed.

Quick start with Botscent

  1. Check you have what it needs: A site built with a supported framework such as Next.js, Express, Django or FastAPI; npm for the TypeScript package or pip for the Python package; Permission to edit your site's server code and page layout.
  2. Open nalinbhardwaj/botscent on GitHub and read the README and license.
  3. Run npm install botscent in the project, or pip install botscent for a Python server.
  4. Add the page half for your framework, following the Quickstart section for that framework.
  5. Add the server half, for example app.use(botscent()) in Express, or export { proxy } from 'botscent/next' in Next.js 16 or later.
  6. Send the page verdict to your server with reportHeaders on same-origin requests, then join it with combine(own, report) on the server.

These steps come from our top use case, Log which AI agents visit your site, which also has a copy-paste agent prompt.

Use this in your AI agent

Ask your agent

Using the Deduped MCP, get the setup steps for nalinbhardwaj/botscent

Add Deduped to Claude Code once

claude mcp add --transport http deduped https://dedupedai.com/mcp

Cursor, ChatGPT, others

Botscent alternatives · Best AI repos for Software and DevOps

About this repo

  • Who it is forWeb developers and site owners who want to know which AI agents visit their site and decide what to do about them.
  • Why it is hot74 stars, launched 25 days ago, picked up by one AI source we track
  • LanguageTypeScript
  • Sourcegithub.com/nalinbhardwaj/botscent · Back to Hot repos

Requirements

  • A site built with a supported framework such as Next.js, Express, Django or FastAPI
  • npm for the TypeScript package or pip for the Python package
  • Permission to edit your site's server code and page layout
  • A running site URL to test against

Add this badge to your README

Maintain Botscent? Show readers where to find these use cases. Use cases on Deduped

Markdown 

[![Use cases on Deduped](https://dedupedai.com/badge/nalinbhardwaj/botscent.svg)](https://dedupedai.com/use-cases/nalinbhardwaj-botscent/?utm_source=github&utm_medium=badge&utm_campaign=nalinbhardwaj-botscent)

HTML 

<a href="https://dedupedai.com/use-cases/nalinbhardwaj-botscent/?utm_source=github&amp;utm_medium=badge&amp;utm_campaign=nalinbhardwaj-botscent"><img src="https://dedupedai.com/badge/nalinbhardwaj/botscent.svg" alt="Use cases on Deduped" height="20"></a>

A static image, no tracking script. About the badge

Questions about Botscent

What is Botscent?

Botscent is a small open-source TypeScript and Python library that tells a site whether an AI agent, not a person, is browsing it and which agent it is. It is an open-source project on GitHub: https://github.com/nalinbhardwaj/botscent.

How do I use Botscent?

Run npm install botscent in the project, or pip install botscent for a Python server; then add the page half for your framework, following the Quickstart section for that framework; add the server half, for example app.use(botscent()) in Express, or export { proxy } from 'botscent/next' in Next.js 16 or later. The use cases on this page give the full steps and a copy-paste agent prompt for each job.

Who is Botscent for?

Web developers and site owners who want to know which AI agents visit their site and decide what to do about them.

What can I do with Botscent?

4 use cases so far, for example: Log which AI agents visit your site; Let only verified AI agents through; Change page content when an AI agent visits. Each has steps and a copy-paste agent prompt.

What do I need to run Botscent?

A site built with a supported framework such as Next.js, Express, Django or FastAPI; npm for the TypeScript package or pip for the Python package; Permission to edit your site's server code and page layout; A running site URL to test against.

What are alternatives to Botscent?

Other hot AI repos in Software and DevOps: Deep Infer, Harness2, Orca, Opencode, Graphify.

Is Botscent safe to run?

Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.