Twitter

{
  "name": "twitter",
  "version": "1.0.0",
  "description": "Search and retrieve content from Twitter/X. Get user info, tweets, replies, followers, communities, spaces, and trends via twitterapi.io.",
  "author": {
    "name": "ReScienceLab"
  },
  "homepage": "https://github.com/ReScienceLab/opc-skills/tree/main/skills/twitter",
  "repository": "https://github.com/ReScienceLab/opc-skills",
  "license": "MIT",
  "keywords": [
    "twitter",
    "X",
    "tweet"
  ],
  "skills": [
    "./SKILL.md"
  ],
  "commands": [
    "./scripts/"
  ]
}

#!/usr/bin/env python3
"""
Batch get user info by user IDs
Usage: python3 scripts/batch_get_users.py USER_ID1,USER_ID2,USER_ID3
"""
import argparse
from twitter_api import api_get, print_users_list


def main():
    parser = argparse.ArgumentParser(description="Batch get Twitter users by IDs")
    parser.add_argument("user_ids", help="Comma-separated user IDs")
    args = parser.parse_args()

    data = api_get("user/batch_info_by_ids", {"userIds": args.user_ids})
    users = data.get("users") or data.get("data") or []
    
    print(f"total: {len(users)}")
    print_users_list(users)


if __name__ == "__main__":
    main()


#!/usr/bin/env python3
"""
Check follow relationship between two users
Usage: python3 scripts/check_relationship.py USER1 USER2
"""
import argparse
from twitter_api import api_get


def main():
    parser = argparse.ArgumentParser(description="Check follow relationship")
    parser.add_argument("source", help="Source username")
    parser.add_argument("target", help="Target username")
    args = parser.parse_args()

    params = {"source_user_name": args.source, "target_user_name": args.target}
    data = api_get("user/check_follow_relationship", params)
    result = data.get("data") or data

    print(f"source: @{args.source}")
    print(f"target: @{args.target}")
    print(f"source_follows_target: {result.get('following', False)}")
    print(f"target_follows_source: {result.get('followed_by', False)}")


if __name__ == "__main__":
    main()


#!/usr/bin/env python3
"""
Twitter API credential management.
Reads from environment: TWITTERAPI_API_KEY
"""
import os


def get_twitter_api_key() -> str | None:
    """Get TwitterAPI.io API key"""
    return os.environ.get("TWITTERAPI_API_KEY")


def has_twitter_key() -> bool:
    """Check if API key is available"""
    return get_twitter_api_key() is not None


#!/usr/bin/env python3
"""
Get long-form article from tweet
Usage: python3 scripts/get_article.py TWEET_ID
"""
import argparse
import json
from twitter_api import api_get


def main():
    parser = argparse.ArgumentParser(description="Get Twitter article")
    parser.add_argument("tweet_id", help="Tweet ID with article")
    parser.add_argument("--json", "-j", action="store_true", help="Output as JSON")
    args = parser.parse_args()

    data = api_get("article", {"tweet_id": args.tweet_id})
    article = data.get("data") or data

    if args.json:
        print(json.dumps(article, indent=2))
        return

    print(f"tweet_id: {args.tweet_id}")
    if article.get("title"):
        print(f"title: {article['title']}")
    if article.get("content"):
        print(f"---")
        print(article["content"][:2000])
        if len(article.get("content", "")) > 2000:
            print(f"... (truncated, {len(article['content'])} chars total)")


if __name__ == "__main__":
    main()


#!/usr/bin/env python3
"""
Get community members
Usage: python3 scripts/get_community_members.py COMMUNITY_ID --limit 20
"""
import argparse
from twitter_api import api_get, print_users_list, print_pagination


def main():
    parser = argparse.ArgumentParser(description="Get community members")
    parser.add_argument("community_id", help="Community ID")
    parser.add_argument("--limit", "-l", type=int, default=20, help="Max members")
    parser.add_argument("--cursor", "-c", help="Pagination cursor")
    args = parser.parse_args()

    params = {"communityId": args.community_id, "cursor":