Skip to content

docs(agent-bases): clarify APIFY_TOKEN, add Playwright MCP and CLI search#766

Merged
patrikbraborec merged 3 commits into
masterfrom
feat/agents-md-token-mcp-search
May 13, 2026
Merged

docs(agent-bases): clarify APIFY_TOKEN, add Playwright MCP and CLI search#766
patrikbraborec merged 3 commits into
masterfrom
feat/agents-md-token-mcp-search

Conversation

@patrikbraborec
Copy link
Copy Markdown
Contributor

Summary

  • Add Apify Platform Environment section clarifying that the API token is auto-available via APIFY_TOKEN (not APIFY_API_TOKEN) when running on the platform, and is read by the SDK automatically.
  • Promote MCP Tools to a parent section with Apify MCP and Playwright MCP (debugging) subsections; Playwright MCP includes both the claude mcp add one-liner and a JSON config snippet.
  • Document apify actors search "<query>" --user-agent <your-agent-name> for discovering community Actors before building from scratch.

Changes applied consistently to python.AGENTS.md, js.AGENTS.md, and ts.AGENTS.md.

Test plan

  • Verify all three AGENTS.md files render correctly on GitHub
  • Confirm the three sections (Apify Platform Environment, MCP Tools, Commands) read well in context
  • Spot-check that no existing content was accidentally removed

🤖 Generated with Claude Code

…arch

- Add Apify Platform Environment section noting that APIFY_TOKEN (not
  APIFY_API_TOKEN) is auto-available on the platform and read by the SDK.
- Promote MCP section to a parent with Apify MCP and Playwright MCP
  subsections; document Playwright MCP as a debugging tool with install
  instructions.
- Document `apify actors search` for discovering community Actors before
  building from scratch.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@github-actions github-actions Bot added this to the 140th sprint - DX team milestone May 12, 2026
@github-actions github-actions Bot added the t-dx Issues owned by the DX team. label May 12, 2026
Add the most important commands developers need when building Actors:
bootstrap (create/init), local dev (run/validate-schema), auth/account
(login/logout/info), deployment & remote execution (push/pull/call/build,
runs ls), discovery (actors search/info), secrets (referenced via
"@name" in actor.json), and direct API access (apify api). The ts
variant also documents `apify actor generate-schema-types`.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
pull Bot pushed a commit to jinzaizhichi/agent-skills that referenced this pull request May 12, 2026
…ization

Aligns the Actor development and Actorization skills with apify/actor-templates#766:
expanded CLI command reference (including Apify Store discovery via `apify actors
search`), an `APIFY_TOKEN` clarification, and an MCP tools section that adds
Playwright MCP for debugging.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copy link
Copy Markdown
Contributor

@DaveHanns DaveHanns left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM 👍

Shouldn't @szaganek review this as well?

Copy link
Copy Markdown
Contributor

@szaganek szaganek left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd just add verbs for the sake of consistency.

Comment thread agent-bases/python.AGENTS.md Outdated
Comment thread agent-bases/python.AGENTS.md Outdated
Comment thread agent-bases/python.AGENTS.md Outdated
Co-authored-by: Edyta <142720610+szaganek@users.noreply.github.com>
@patrikbraborec patrikbraborec enabled auto-merge (squash) May 13, 2026 10:21
@patrikbraborec patrikbraborec merged commit 04b12ad into master May 13, 2026
42 checks passed
@patrikbraborec patrikbraborec deleted the feat/agents-md-token-mcp-search branch May 13, 2026 11:19
@B4nan
Copy link
Copy Markdown
Member

B4nan commented May 14, 2026

this might have broken the e2e tests, we need to reformat the files

https://github.com/apify/actor-templates/actions/runs/25835443656/job/75909415900

i wonder why this didnt pop in the CI checks directly

edit: i guess because we dont check formatting globally and only inside the templates, so when you add the "agents file templates", they are not checked, then they are propagated to each template and that breaks the CI tests. we should check the formatting in a regular PR check too.

B4nan added a commit that referenced this pull request May 14, 2026
## Summary

Adds `prettier --check` to the lint/test workflow. Today, formatting
drift in shared files (notably the `agent-bases/*.AGENTS.md`
source-of-truth that gets fanned out into every template's `AGENTS.md`)
only surfaces *after* merge, when the per-template e2e checks fire — see
the post-merge comment on #766.

This PR adds the check **only**; the resulting CI failure is intentional
and demonstrates the gap. A follow-up commit on the same branch will
reformat the offending files so the check goes green.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@B4nan
Copy link
Copy Markdown
Member

B4nan commented May 14, 2026

Handled via #769

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

t-dx Issues owned by the DX team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants