{"id":15673813,"url":"https://github.com/lmammino/mvp-activities","last_synced_at":"2025-05-06T22:45:24.075Z","repository":{"id":220796970,"uuid":"752613591","full_name":"lmammino/mvp-activities","owner":"lmammino","description":"A simple client to interact with the Microsoft MVP activities API (not official).","archived":false,"fork":false,"pushed_at":"2024-09-15T17:11:12.000Z","size":31,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-06T22:45:17.711Z","etag":null,"topics":["api","api-client","automation","client","mvp"],"latest_commit_sha":null,"homepage":"https://loige.co","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lmammino.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2024-02-04T11:15:12.000Z","updated_at":"2025-03-01T21:56:28.000Z","dependencies_parsed_at":"2024-09-15T18:00:23.269Z","dependency_job_id":"e5a84e35-fd8e-4756-9f48-026c9e5371fe","html_url":"https://github.com/lmammino/mvp-activities","commit_stats":null,"previous_names":["lmammino/mvp-activities"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lmammino%2Fmvp-activities","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lmammino%2Fmvp-activities/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lmammino%2Fmvp-activities/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lmammino%2Fmvp-activities/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lmammino","download_url":"https://codeload.github.com/lmammino/mvp-activities/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252782459,"owners_count":21803380,"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":["api","api-client","automation","client","mvp"],"created_at":"2024-10-03T15:42:13.271Z","updated_at":"2025-05-06T22:45:24.053Z","avatar_url":"https://github.com/lmammino.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mvp-activities\n\nA simple client to interact with the Microsoft MVP activities API (not\nofficial).\n\n[![build](https://github.com/lmammino/mvp-activities/actions/workflows/build.yml/badge.svg)](https://github.com/lmammino/mvp-activities/actions/workflows/build.yml)\n[![npm](https://img.shields.io/npm/v/mvp-activities)](https://www.npmjs.com/package/mvp-activities)\n[![release-please](https://badgen.net/static/release-please/%F0%9F%99%8F/green)](https://github.com/googleapis/release-please)\n[![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-%23FE5196?logo=conventionalcommits\u0026logoColor=white)](https://conventionalcommits.org)\n\nThe main use case is to be used to automate the management (submissions,\nupdates, etc.) of MVP activities.\n\nFor some usage examples check the [`examples`](/examples) directory.\n\n## Before getting started\n\nInstall the package with one of the following commands (based on your favourite\npackage manager):\n\n```bash\nnpm install mvp-activities\n```\n\n```bash\nyarn add mvp-activities\n```\n\n```bash\npnpm add mvp-activities\n```\n\n## Example usage\n\nThe following example lists all your submitted activities and submits a new one:\n\n```javascript\nimport { MVPActivitiesClient } from \"mvp-activities\";\n\n// You'll need to get a token from the MVP activities website (see below) and your MVP email\n// If you don't pass these parameters the client will try to look for them in the following environment variables:\n// - `MVP_API_TOKEN`\n// - `MVP_API_EMAIL`\nconst client = new MVPActivitiesClient(token, mvpEmail);\n\n// Needed to initialize the client (it will fetch the user profile information needed for other requests)\nawait client.init();\n\n// List all activities\nconst activities = await client.getSubmittedActivities();\n\nfor (const activity of activities) {\n  console.log(`${activity.date.substring(0, 10)} - ${activity.title}`);\n}\n\n// Submit a new activity\nconst newActivity = {\n  activityTypeName: \"Blog\",\n  typeName: \"Blog\",\n  date: \"2024-02-04T00:00:00.000Z\",\n  description: \"A new blog post\",\n  privateDescription: \"A new blog post\",\n  isPrivate: false,\n  targetAudience: [\n    \"Developer\",\n    \"IT Pro\",\n    \"Technical Decision Maker\",\n    \"Student\",\n  ],\n  tenant: \"MVP\",\n  title: \"My new blog post\",\n  url: \"https://loige.co/some-blog-post\",\n  reach: 2000,\n  quantity: 1,\n  role: \"Author\",\n  technologyFocusArea: \"Web Development\",\n  additionalTechnologyAreas: [\"Developer Tools\", \"DevOps\"],\n  imageUrl: \"https://loige.co/og/some-blog-post.png\",\n};\n\nconst newActivityResult = await client.submitActivity(newActivity);\nconsole.log(newActivityResult);\n```\n\n## Get a token\n\n1. Go to your account in the\n   [MVP activities website](https://mvp.microsoft.com/en-US/account/)\n2. Open the browser developer tools and go to the \"Network\" tab\n3. Filter requests by XHR / Ajax\n4. Visit the Activities/My Activities section\n5. Look for a request called `Search` and copy the token from the\n   `Authorization` header from the request headers (make sure not to copy the\n   `Bearer` prefix)\n\n## Contributing\n\nEveryone is very welcome to contribute to this project. You can contribute just\nby submitting bugs or suggesting improvements by\n[opening an issue on GitHub](https://github.com/lmammino/mvp-activities/issues).\n\n## License\n\nLicensed under [MIT License](LICENSE). © Luciano Mammino.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flmammino%2Fmvp-activities","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flmammino%2Fmvp-activities","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flmammino%2Fmvp-activities/lists"}