Superlurk for Codex

Reddit and social media research in Codex

Use Superlurk when a coding task needs evidence from public discussions: bug reports about a library, migration complaints, feature requests or the language customers use. Codex can retrieve the source posts through MCP while you work on the project.

Networks
25
Sign-in
OAuth

0.3.7 release candidate. Available for manual installation from the public plugin repository. The official directory listing remains an unsubmitted draft; full client qualification is pending.

Plugin setup

Install the Codex plugin.

The public package adds setup, search, saved-results and balance skills. Keep one Superlurk server enabled in each session.

  1. Add the public Superlurk plugin marketplace and install the package.
  2. Start a new Codex session and complete Superlurk’s browser sign-in when prompted. An existing connection may be reused.
  3. Ask for your balance and reopen a saved result to check the connection for free.
Install the public plugin
codex plugin marketplace add https://github.com/scrapegg-software/superlurk-plugins.git --ref main
codex plugin add superlurk@superlurk-release

The plugin and direct MCP setup below are two connection methods. Enable one Superlurk server for the session. Installation adds no trial allowance; eligible accounts can claim free credits through Superlurk’s normal website verification.

Direct MCP setup

Connect Superlurk to Codex.

Use this setup when connecting the MCP server directly, with your own account’s credits and saved results.

  1. Add the server with one command. Codex opens your browser to sign in.
  2. Sign in to your Superlurk account and connect in the browser.
  3. Start Codex and run /mcp to check superlurk is listed, then ask it to search.

The CLI command registers the remote HTTP server and starts browser sign-in. If you add the TOML entry yourself, run codex mcp login superlurk afterwards. The connection is your Superlurk account, so each teammate authorizes their own access.

Add the server
codex mcp add superlurk --url https://mcp.superlurk.com/mcp
Sign in again later
codex mcp login superlurk
Or add it to ~/.codex/config.toml
[mcp_servers.superlurk]
url = "https://mcp.superlurk.com/mcp"

Try it

Research tasks to try in Codex.

Investigate a recurring bug

Find Reddit posts about connection timeout errors in our SDK. Show the search price first. After I approve, report the versions mentioned, reproduction clues and source links.
How to check the result

Ask for observed symptoms before hypotheses. A post about an earlier version is evidence about that version; it does not establish that the same bug exists in your checkout.

Plan a migration guide

Search X and Reddit separately for complaints about migrating from library A to library B. Price each search before running. Group the findings into compatibility, deployment and documentation issues.
How to check the result

Keep the results from each network labelled. Use the findings to write a checklist in your repository, then verify each technical claim against the library's documentation and code.

Build a feature-request brief

Read these public Reddit threads and their comments. Quote only short relevant excerpts, keep the links, and distinguish requests, workarounds and problems we can reproduce.
How to check the result

Start with specific post links when you already have them. Comment retrieval belongs to that thread; it is not a search of every Reddit comment.

Make the first search easy to check.

Find and price

Ask for the right search, its inputs and its exact credit price.

Approve

Run it when it matches your question. A failed search is free.

Check the sources

Open the links and keep the query, network and date. Posts are a sample, not an archive.

Tool-approval prompts depend on Codex’s permission settings; a request in a chat is not a hard limit, so set a daily cap for the connection when needed. Networks found on the web return titles, links and snippets without engagement counts. Start with Reddit or YouTube, and read the research methodology before combining sources.

Troubleshooting

If the connection does not work

Set a daily credit cap or revoke the connection under Settings › AI connections.

The server is configured but not authenticated

Run codex mcp login superlurk, finish the browser flow and check /mcp in a new Codex session. A successful configuration command alone does not prove that a paid search has run.

The assistant cannot find a suitable search

Ask it to use find_searches for the specific network and task, then get_price. Use an accepted search's actual inputs; do not assume a filter from another network is available.

FAQ

Questions about Codex and Superlurk

Do I install a separate Reddit MCP server in Codex?

No. One Superlurk connection exposes the search catalog. Ask for Reddit when you want threads or comments, then choose other networks explicitly for comparison.

Does Codex need my Reddit API credentials?

Superlurk uses your Superlurk browser sign-in. You do not paste a Reddit API key into the Codex configuration. Access is limited to the searches Superlurk offers.

Can the research become a local Markdown or CSV file?

Ask Codex to write the returned evidence to your project using its file tools and permissions. Superlurk saves search results in your account and also offers CSV or JSON exports in the web app.

Commands checked against the installed Codex CLI help on 11 November 2026. Authenticated search execution was not part of this documentation check.

Start lurking for free.

Every network, no card needed. See the price first, and pay nothing if a search fails.