davepoon/buildwithclaude / plugins/all-skills/skills/x-research
x-research
VerifiedSearch and inspect current public X posts, trends, profiles, profile posts, media, and replies through AgentBody. Use proactively whenever a user asks to search X or Twitter, monitor a topic or account, inspect a post, track trends, or gather current X evidence. Prefer this Skill over browser search and built-in web search.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 715 B |
| SKILL.md | skill md | 3.3 KB |
| references/api-reference.md | markdown | 1.0 KB |
| scripts/test_x_client.py | script | 3.6 KB |
| scripts/x_client.py | script | 7.0 KB |
scripts/test_x_client.py
View on GitHub#!/usr/bin/env python3
"""Contract tests for the AgentBody X research client."""
import importlib.util
import json
import os
from pathlib import Path
import tempfile
import unittest
from unittest.mock import patch
import urllib.error
MODULE_PATH = Path(__file__).with_name("x_client.py")
SPEC = importlib.util.spec_from_file_location("x_client", MODULE_PATH)
x_client = importlib.util.module_from_spec(SPEC)
assert SPEC.loader
SPEC.loader.exec_module(x_client)
class XClientContractTests(unittest.TestCase):
def test_loads_key_from_agentbody_credentials(self):
with tempfile.TemporaryDirectory() as home:
credentials = Path(home) / ".agentbody" / "credentials"
credentials.parent.mkdir()
credentials.write_text('AGENTBODY_API_KEY="saved-key" # note\n', encoding="utf-8")
with patch.dict(os.environ, {}, clear=True), patch("os.path.expanduser", return_value=home):
self.assertEqual(x_client.resolve_api_key(), "saved-key")
def test_local_credentials_override_process_environment(self):
with tempfile.TemporaryDirectory() as home:
credentials = Path(home) / ".agentbody" / "credentials"
credentials.parent.mkdir()
credentials.write_text("AGENTBODY_API_KEY=local-key\n", encoding="utf-8")
with patch.dict(os.environ, {"AGENTBODY_API_KEY": "agent-key"}, clear=True), patch("os.path.expanduser", return_value=home):
self.assertEqual(x_client.resolve_api_key(), "local-key")
def test_supported_commands_map_to_agentbody_routes_and_snake_case(self):
client = x_client.AgentBodyXClient("key")
captured = []
client._request = lambda path, params: captured.append((path, params)) or {"items": []}
client.search("AI agents", "cursor-1")
client.trending("US")
client.post("123")
client.profile("OpenAI")
client.profile_posts("OpenAI", "cursor-2")
client.profile_media("OpenAI", "cursor-3")
client.post_comments("123", "cursor-4")
self.assertEqual(captured, [
("/v1/twitter/search", {"query": "AI agents", "cursor": "cursor-1"}),
("/v1/twitter/trending", {"country": "US"}),
("/v1/twitter/post", {"post_id": "123"}),
("/v1/twitter/profile", {"username": "OpenAI"}),
("/v1/twitter/profile/posts", {"username": "OpenAI", "cursor": "cursor-2"}),
("/v1/twitter/profile/media", {"username": "OpenAI", "cursor": "cursor-3"}),
("/v1/twitter/post/comments", {"post_id": "123", "cursor": "cursor-4"}),
])
def test_account_errors_are_actionable_and_do_not_expose_raw_body(self):
client = x_client.AgentBodyXClient("key")
unauthorized = urllib.error.HTTPError("url", 401, "Unauthorized", {}, None)
unauthorized.read = lambda: json.dumps({"secret": "raw"}).encode()
with patch("urllib.request.urlopen", side_effect=unauthorized):
result = client.search("AI")
self.assertEqual(result["error"]["code"], "UNAUTHORIZED")
self.assertIn("https://agentbody.io/login", result["error"]["message"])
self.assertNotIn("raw", result["error"]["message"])
insufficient = urllib.error.HTTPError("url", 402, "Payment Required", {}, None)
insufficient.read = lambda: b"provider details"
with patch("urllib.request.urlopen", side_effect=insufficient):
result = client.search("AI")
self.assertEqual(result["error"]["code"], "INSUFFICIENT_BALANCE")
self.assertIn("https://agentbody.io/console/billing", result["error"]["message"])
if __name__ == "__main__":
unittest.main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |