social-media-toolkit: Instructions file for Codex

AGENTS.md

social-media-toolkit AGENTS.md is an instructions file for Codex, OpenCode from JNHFlow21/social-media-toolkit. It costs 1,026 tokens per session, scanned C, original, Apache-2.0.

Repository instructions for a public social-media toolkit that extracts text and transcripts through a command-line interface and MCP server. It separates public reading from optional private analytics and publishing automation.

In plain words
What is it for?
Use them when developing extraction, transcription, subtitle, metadata, CLI, or MCP features, or when deciding whether account access or publishing belongs in the project.
Why use it?
They define product boundaries, text-source precedence, transcript rules, authentication limits, and secret-handling requirements so changes do not violate the toolkit's contracts.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md.

This is JNHFlow21/social-media-toolkit's own configuration. It tells Codex and OpenCode how to work on social-media-toolkit itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything social-media-toolkit configures →

Reuse

Borrowing it

Nothing to install: this file belongs to JNHFlow21/social-media-toolkit. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/JNHFlow21/social-media-toolkit/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/JNHFlow21/social-media-toolkit

Made for: Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for social-media-toolkit AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/jnhflow21/social-media-toolkit/agents-md/github.svg)](https://agentmods.dev/instructions/jnhflow21/social-media-toolkit/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/jnhflow21/social-media-toolkit/agents-md"><img src="https://agentmods.dev/badge/instructions/jnhflow21/social-media-toolkit/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for social-media-toolkit AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/jnhflow21/social-media-toolkit/agents-md"><img src="https://agentmods.dev/badge/instructions/jnhflow21/social-media-toolkit/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 1,026 This file is loaded in full into every session.
When invoked 1,026 The same file — it is already loaded in full.
Security scan C 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.01026 $0.01026
Opus 5.5 $0.00410 $0.00410
Sonnet 5.5 $0.00205 $0.00205
Haiku 4.5 $0.00103 $0.00103

Measured 2mo ago against content hash 79f1f92aec47, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade C, and why

social-media-toolkit AGENTS.md scanned grade C with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Harvests environment variableshighData exfiltration

Enumerating or grepping the environment for keys collects credentials unrelated to what the mod says it does.

11. The NPX path must be a real tested installer, not a documentation alias. It must not collect credentials, load project secrets, or duplicate Python runtime behavior in JavaScript.
AGENTS.md · 66 lines

How it starts

The opening of the file, as written. The whole thing — 66 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Agent Development Protocol

This repository is a public, reusable product. It must not depend on the Brain vault or any private user workspace.

Product boundary

  • Core package: social_media_toolkit.
  • Thin MCP transport: social_post_extractor_mcp.
  • Thin npm bootstrap: package.json plus bin/social-media-toolkit.mjs; it may install uv and must delegate the actual CLI/MCP installation to uv tool.
  • Public read paths must not require browser automation, CDP, Playwright, or a logged-in session.
  • Account-private analytics remain optional and isolated.
  • Publishing/upload automation belongs in a separate future package because it has authenticated side effects.

Invariants

  1. Plain canonical-text precedence is GetNote original content → native platform subtitle → Volcengine cloud ASR.
  2. Timed YouTube transcripts are a separate evidence contract: manual subtitle cues → automatic subtitle cues → timestamped Volcengine cloud ASR. Callers may explicitly force Volcengine ASR, optionally with anonymous speaker diarization and bounded public-metadata context; that mode must bypass native captions. Non-timestamped GetNote text must not short-circuit either route.
  3. Non-empty GetNote original content wins even when a task still contains a stale error message on the plain canonical-text route.
  4. Douyin media resolution uses the free public adapter first. Only after that adapter fails, and only when TIKHUB_API_KEY is configured, may the single orchestrator call TikHub for temporary public CDN URLs. Preserve the paid route and ephemeral-URL warning in provenance.
  5. inspect and plain text do not download persistent media. Timed text requires an explicit output directory and may write only requested transcript artifacts; media remains temporary. Downloads require an explicit output directory.
  6. Every normalized result preserves provenance, warnings, platform limitations, and paid-route disclosure.
  7. SDK, CLI, and MCP must call the same SocialMediaToolkit; do not add legacy aliases or a second scheduler.
  8. Volcengine is the only ASR provider. TikHub resolves media only; do not treat it as a text/ASR provider or add local ASR/another cloud fallback.
  9. Never claim a public comment sample is a global platform ranking.
  10. A plain text, text-enabled capture, timed-text, or full-chain smoke-test request runs its configured text route automatically. Do not ask for a second authorization; report the route and any possible usage charge afterward.
  11. The NPX path must be a real tested installer, not a documentation alias. It must not collect credentials, load project secrets, or duplicate Python runtime behavior in JavaScript.
  12. The current MCP transport uses the v1 FastMCP API and must keep mcp>=1.28.1,<2 until a dedicated MCP 2.x migration lands. CI must execute a real stdio initialize handshake, not just compile the module.

Read the full file on GitHub · 66 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2mo ago First seen · 66 lines · 1,026 tokens per session scan C 79f1f92aec47

Subscribe to this mod's changes

social-media-toolkit AGENTS.md is an instructions file published in the GitHub repository JNHFlow21/social-media-toolkit (31 stars, last pushed 18d ago), licensed Apache-2.0. It adds 1,026 tokens to every session, about $0.0041 per session on Opus 5.5. A static security scan graded it C with 1 finding (harvests environment variables). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

social-media-toolkit AGENTS.md compared with instructions from other repositories

social-media-toolkit AGENTS.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
social-media-toolkit AGENTS.mdJNHFlow21/social-media-toolkitInstructions file3118d agoApache-2.0C1,026Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143kyesterdayMITA7,461Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchainInstructions file149kyesterdayMITA4,680Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA5,516GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA3,093GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harnessInstructions file274k2d agoMITA4,313Codex, OpenCode