{"id":28900277,"url":"https://github.com/sing1ee/a2a-js-movie-agent","last_synced_at":"2025-06-30T03:37:14.226Z","repository":{"id":299358125,"uuid":"1002713220","full_name":"sing1ee/a2a-js-movie-agent","owner":"sing1ee","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-16T05:15:56.000Z","size":394,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-16T06:23:07.485Z","etag":null,"topics":["a2a","a2a-cli","a2a-protocol","a2a-server","openrouter","tmdb-api"],"latest_commit_sha":null,"homepage":"https://a2aprotocol.ai/blog/a2a-js-movie-agent","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sing1ee.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-16T02:57:19.000Z","updated_at":"2025-06-16T05:44:33.000Z","dependencies_parsed_at":"2025-06-16T06:33:18.998Z","dependency_job_id":null,"html_url":"https://github.com/sing1ee/a2a-js-movie-agent","commit_stats":null,"previous_names":["sing1ee/a2a-js-movie-agent"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sing1ee/a2a-js-movie-agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sing1ee%2Fa2a-js-movie-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sing1ee%2Fa2a-js-movie-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sing1ee%2Fa2a-js-movie-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sing1ee%2Fa2a-js-movie-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sing1ee","download_url":"https://codeload.github.com/sing1ee/a2a-js-movie-agent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sing1ee%2Fa2a-js-movie-agent/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261101636,"owners_count":23109860,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["a2a","a2a-cli","a2a-protocol","a2a-server","openrouter","tmdb-api"],"created_at":"2025-06-21T09:39:38.722Z","updated_at":"2025-06-30T03:37:14.203Z","avatar_url":"https://github.com/sing1ee.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# A2A JS Movie Agent\n\nA movie information agent powered by TMDB API and AI.\n\n## Features\n\n- **Enhanced TMDB Integration**: Modern API implementation with Bearer token authentication\n- **Comprehensive Movie Search**: Search with filters like year, adult content, etc.\n- **Detailed Movie Information**: Get complete movie details including cast, crew, videos, and more\n- **Multi-Search**: Search across movies, TV shows, and people simultaneously\n- **Smart API Usage**: Efficient search + details combination following TMDB best practices\n- **AI-Powered**: Uses OpenRouter for intelligent movie queries\n- **Proxy Support**: Built-in SOCKS5/HTTP proxy support for network requests\n\n## Environment Setup\n\nCreate a `.env` file with the following variables:\n\n```bash\n# TMDB API Key (can be used as Bearer token)\nTMDB_API_TOKEN=your_TMDB_API_TOKEN_here\n\n# OpenRouter API Key for AI features\nOPENROUTER_API_KEY=your_openrouter_api_key_here\n\n# Proxy Configuration (Optional)\n# Set USE_PROXY=true to enable proxy, default is true\nUSE_PROXY=true\n\n# Proxy URL - supports socks5, http, https protocols\n# Default: socks5://127.0.0.1:7890\nPROXY_URL=socks5://127.0.0.1:7890\n\n# Optional\nNODE_ENV=development\nPORT=3000\n```\n\n### Proxy Configuration\n\nThe application supports proxy connections for TMDB API requests:\n\n- **Supported Protocols**: SOCKS5, HTTP, HTTPS\n- **Default Setting**: Proxy is enabled by default with `socks5://127.0.0.1:7890`\n- **Environment Variables**:\n  - `USE_PROXY`: Set to `true` or `false` to enable/disable proxy\n  - `PROXY_URL`: Proxy server URL (e.g., `socks5://127.0.0.1:7890`, `http://proxy.example.com:8080`)\n\n## TMDB API Features\n\nThe project now includes enhanced TMDB API features based on official documentation:\n\n### Available Tools\n\n1. **searchMovies**: Basic movie search with optional filters\n2. **searchPeople**: Search for actors, directors, etc.\n3. **getMovieDetails**: Get detailed information about a specific movie\n4. **searchMoviesWithDetails**: Combined search + details in one call (recommended)\n5. **multiSearch**: Search across all content types simultaneously\n\n### Key Improvements\n\n- ✅ **Bearer Token Authentication**: Modern authentication method\n- ✅ **Type Safety**: Full TypeScript definitions for all API responses\n- ✅ **Append to Response**: Get additional data (videos, credits) in single requests\n- ✅ **Image URL Optimization**: Automatic full URL generation for all images\n- ✅ **Error Handling**: Comprehensive error handling and logging\n- ✅ **Backward Compatibility**: Legacy API functions still work with deprecation warnings\n\n## Development\n\n```bash\n# Install dependencies\nbun install\n\n# Run development server\nbun dev\n\n# Build project\nbun run build\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsing1ee%2Fa2a-js-movie-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsing1ee%2Fa2a-js-movie-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsing1ee%2Fa2a-js-movie-agent/lists"}