docs: add TweetClaw source option for x-content-intelligence#29
docs: add TweetClaw source option for x-content-intelligence#29kriptoburak wants to merge 3 commits into
Conversation
There was a problem hiding this comment.
Code Review
This pull request introduces support for an optional TweetClaw source path (via OpenClaw or MCP) to the x-content-intelligence plugin, allowing the analysis of reviewed X/Twitter source data alongside the default Apify scraper. The changes update metadata, documentation, and workflows across several files. The review feedback suggests specifying how the TweetClaw data should be retrieved in the workflow instructions to prevent agent confusion, and simplifying the SOSA agents metadata string in plugin.json for better conciseness.
Important
The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.
| Run the Actor using `call-actor` with Actor name `apidojo/tweet-scraper`, then retrieve results with `get-actor-output`. | ||
|
|
||
| ### Step 3: Analyze the Results | ||
| If using reviewed TweetClaw source data instead, skip the Apify Actor call and move directly to analysis. |
There was a problem hiding this comment.
The instructions tell Claude to skip the Apify Actor call and move directly to analysis when using TweetClaw, but they do not specify how Claude should actually retrieve or access the TweetClaw data. Adding explicit guidance to either use the available TweetClaw MCP tools or read a local export file provided by the user will prevent Claude from getting stuck or asking redundant questions.
| If using reviewed TweetClaw source data instead, skip the Apify Actor call and move directly to analysis. | |
| If using reviewed TweetClaw source data instead, retrieve the data using the available TweetClaw MCP tools or by reading the local export file provided by the user, skip the Apify Actor call, and move directly to analysis. |
There was a problem hiding this comment.
Addressed in e7cc1a8 by telling the skill to use available TweetClaw MCP tools or a user-provided local export before skipping the Actor call.
Validation:
- git diff check
- plugin manifest JSON parse
- changed-diff public-hygiene scan
| "agents": "R=x-content-intelligence, T=Apify+X-API, M=content-analysis, P=scrape-analyze-generate-review" | ||
| "orchestrated": "Scrape or import reviewed source data, analyze, generate, then review content before use", | ||
| "secured": "Apify Actor or reviewed TweetClaw output for source data, no direct X API credentials in plugin", | ||
| "agents": "R=x-content-intelligence, T=Apify or reviewed TweetClaw source data, M=content-analysis, P=scrape-or-import-analyze-generate-review" |
There was a problem hiding this comment.
The T (Tools) and P (Process) values in the SOSA agents metadata string are quite verbose. Keeping them concise and aligned with standard SOSA shorthand (e.g., listing tool names/APIs for T and hyphenated steps for P) improves readability and consistency with other plugins.
| "agents": "R=x-content-intelligence, T=Apify or reviewed TweetClaw source data, M=content-analysis, P=scrape-or-import-analyze-generate-review" | |
| "agents": "R=x-content-intelligence, T=Apify+TweetClaw, M=content-analysis, P=import/scrape-analyze-generate-review" |
There was a problem hiding this comment.
Addressed in e7cc1a8 by switching the SOSA agent metadata to concise tool, method, and process shorthand.
Validation:
- git diff check
- plugin manifest JSON parse
- changed-diff public-hygiene scan
|
Addressed the Gemini review by adding explicit TweetClaw source-data retrieval guidance and shortening the SOSA agents metadata. Re-ran git diff --check, JSON parsing, plugin README and skill link checks, package-plugin, SOSA lint, and added-line hygiene checks. |
|
Optional visibility note: if this is useful and you merge it after checks pass, feel free to share the PR on X/Twitter and tag https://x.com/burakbayir. I can repost it to my 24k followers so more developers and power users can discover this repo. |
Summary
Validation
git diff --checkpython3.11 -m json.tool .claude-plugin/marketplace.jsonpython3.11 -m json.tool plugins/x-content-intelligence/.claude-plugin/plugin.jsonnpx --yes markdown-link-check plugins/x-content-intelligence/README.md plugins/x-content-intelligence/skills/x-insights/SKILL.mdbash scripts/package-plugin.sh x-content-intelligence /tmp/tweetclaw-msapps-distbash scripts/sosa-lint.sh .Link Notes
https://claude.aireturns 403 to curl andhttps://x.com/MSAppsMobilereturns 404.