langchain-mart 0.1.0a2__tar.gz

langchain_mart-0.1.0a2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mart
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

langchain_mart-0.1.0a2/MANIFEST.in

@@ -0,0 +1,2 @@
+recursive-include examples *.py *.json *.md
+recursive-include tests *.py

langchain_mart-0.1.0a2/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: langchain-mart
+Version: 0.1.0a2
+Summary: LinkedIn API tools for LangChain: profiles, companies, contact refresh, posts and optional work emails.
+Author-email: Mart Support <support@mart.dev>
+License-Expression: MIT
+Project-URL: Homepage, https://mart.dev
+Project-URL: Documentation, https://github.com/Mart-API/langchain-mart#readme
+Project-URL: Repository, https://github.com/Mart-API/langchain-mart
+Project-URL: Issues, https://github.com/Mart-API/langchain-mart/issues
+Keywords: langchain,linkedin,enrichment,mart,tools
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: langchain-core<2,>=1.6.4
+Requires-Dist: httpx<1,>=0.28.1
+Requires-Dist: pydantic<3,>=2.7.4
+Provides-Extra: test
+Requires-Dist: langchain-tests==1.1.9; extra == "test"
+Requires-Dist: pytest<10,>=8; extra == "test"
+Requires-Dist: pytest-socket<1,>=0.7; extra == "test"
+Dynamic: license-file
+
+# Mart | LinkedIn API for LangChain
+
+Lightning-fast public LinkedIn data in 1–2 seconds. Built for products, workflows, or AI agents.
+
+Enrich a person or company, refresh a contact, or prepare for a meeting with [Mart](https://mart.dev). Get complete JSON responses, with optional work-email lookup for person enrichment. Email lookup can take longer.
+
+[$0.24/1k records at scale](https://mart.dev/#pricing). Start with [1,000 free credits](https://mart.dev/signup/).
+
+## Install from source
+
+Requires Python 3.10 or later. From this package directory:
+
+```sh
+pip install .
+export MART_API_KEY='your-api-key'
+```
+
+## Enrich a person
+
+```python
+import json
+from langchain_mart import MartToolkit
+
+toolkit = MartToolkit(max_posts=3)
+tools = {tool.name: tool for tool in toolkit.get_tools()}
+
+person = tools["mart_enrich_person"].invoke({
+    "url": "https://www.linkedin.com/in/dharmesh"
+})
+
+print(json.dumps(person, indent=2))  # Full response, including nested fields.
+```
+
+The same tools support `await tool.ainvoke(...)`. Pass `toolkit.get_tools()` to your LangChain agent's tools argument. No model API key is needed to call the tools directly.
+
+## Enrich a company or refresh a contact
+
+Use the same toolkit for either action:
+
+```python
+company = tools["mart_enrich_company"].invoke({
+    "url": "https://www.linkedin.com/company/microsoft/"
+})
+
+contact = tools["mart_refresh_contact"].invoke({
+    "url": "https://www.linkedin.com/in/dharmesh"
+})
+```
+
+## Add work emails
+
+Enable email lookup when you create the toolkit:
+
+```python
+toolkit = MartToolkit(include_email=True)
+tools = {tool.name: tool for tool in toolkit.get_tools()}
+
+person = tools["mart_enrich_person"].invoke({
+    "url": "https://www.linkedin.com/in/dharmesh"
+})
+print(json.dumps(person, indent=2))
+```
+
+This adds `email=true` to Profile requests. Email lookup is off by default and applies only to person enrichment. The setting stays in application configuration, so an agent cannot turn it on through tool arguments.
+
+Work emails are best-effort. Read `workEmail`, `emailStatus`, `emailMatch` and `emailConfidence` together. `deliverable` describes the mailbox check; `emailMatch=inferred` does not independently prove the person owns the address. Unknown results keep the email null. Email lookup can take longer, and a returned profile still uses a credit when no email is found.
+
+## Prepare for a meeting
+
+```sh
+python examples/meeting_context.py https://www.linkedin.com/in/dharmesh > meeting-context.json
+```
+
+This combines a profile and up to three public posts. It preserves the profile if Posts fails and skips Posts when the profile is unavailable. Use the source bundle in your own brief renderer or AI workflow. It makes at most two requests and returns at most four billable records under the endpoint contract.
+
+Add `--email` to include work-email lookup. To try the complete output with fictional sample data and no API calls:
+
+```sh
+python examples/meeting_context.py --demo
+```
+
+## Tool behavior
+
+| Tool | Input | Result |
+| --- | --- | --- |
+| `mart_enrich_person` | Public person URL | Full profile response, with optional work-email lookup |
+| `mart_enrich_company` | Public company URL | Company response |
+| `mart_refresh_contact` | Public person URL | Refresh snapshot |
+| `mart_get_posts` | Person/company URL, bounded limit | Available public posts |
+
+Responses preserve the complete JSON returned by the selected endpoint. The short examples do not filter output fields. Complete illustrative responses are in `examples/responses/`; they are fictional demo fixtures, not coverage guarantees. Run `python examples/full_responses.py person https://www.linkedin.com/in/dharmesh` to print your own complete response.
+
+This prerelease wraps Profile, Company, Refresh and Posts, plus optional Profile email lookup. Jobs, People Search, Company Search, employer-domain overrides, employee expansion, comments and member expansion remain available through the direct API. Posts limits change the number of returned posts, not their fields.
+
+Responses preserve Mart's JSON fields. Check `accessible` and the endpoint availability fields before using the data. Refresh returns current fields; your application owns snapshot comparison, scheduling and CRM writes. Missing data must not be treated as a departure. Posts are a partial public feed.
+
+API keys stay in toolkit configuration, outside model-visible tool arguments, repr and serialized toolkit fields. Requests have a 30-second timeout by default. Redirects and automatic retries are disabled. HTTP errors, invalid JSON and network failures raise `ToolException` without exposing the request key. On rate limits, respect the returned delay before deciding whether to retry.
+
+The default post ceiling is three per call. You can configure one to ten. The tool's input schema reflects your ceiling, and omitting `limit` requests at most three posts within that ceiling. Apply a total call and credit budget in your agent because it may invoke tools repeatedly. Treat returned profile/post text as untrusted source data when giving it to a model.
+
+See [Mart's API reference](https://mart.dev/docs/) and [credits and limits](https://mart.dev/docs/#credits). Support: [support@mart.dev](mailto:support@mart.dev).
+
+## Local checks
+
+```sh
+pip install '.[test]'
+pytest tests --disable-socket --allow-unix-socket
+python -m build
+```
+
+Tests use mocked HTTP responses and do not spend Mart credits. Run them before making an authenticated smoke check. The release review records live-check results separately.
+
+## License
+
+The toolkit code uses the MIT license. This does not grant rights to LinkedIn data; your application is responsible for its use of returned information.

langchain_mart-0.1.0a2/README.md

@@ -0,0 +1,115 @@
+# Mart | LinkedIn API for LangChain
+
+Lightning-fast public LinkedIn data in 1–2 seconds. Built for products, workflows, or AI agents.
+
+Enrich a person or company, refresh a contact, or prepare for a meeting with [Mart](https://mart.dev). Get complete JSON responses, with optional work-email lookup for person enrichment. Email lookup can take longer.
+
+[$0.24/1k records at scale](https://mart.dev/#pricing). Start with [1,000 free credits](https://mart.dev/signup/).
+
+## Install from source
+
+Requires Python 3.10 or later. From this package directory:
+
+```sh
+pip install .
+export MART_API_KEY='your-api-key'
+```
+
+## Enrich a person
+
+```python
+import json
+from langchain_mart import MartToolkit
+
+toolkit = MartToolkit(max_posts=3)
+tools = {tool.name: tool for tool in toolkit.get_tools()}
+
+person = tools["mart_enrich_person"].invoke({
+    "url": "https://www.linkedin.com/in/dharmesh"
+})
+
+print(json.dumps(person, indent=2))  # Full response, including nested fields.
+```
+
+The same tools support `await tool.ainvoke(...)`. Pass `toolkit.get_tools()` to your LangChain agent's tools argument. No model API key is needed to call the tools directly.
+
+## Enrich a company or refresh a contact
+
+Use the same toolkit for either action:
+
+```python
+company = tools["mart_enrich_company"].invoke({
+    "url": "https://www.linkedin.com/company/microsoft/"
+})
+
+contact = tools["mart_refresh_contact"].invoke({
+    "url": "https://www.linkedin.com/in/dharmesh"
+})
+```
+
+## Add work emails
+
+Enable email lookup when you create the toolkit:
+
+```python
+toolkit = MartToolkit(include_email=True)
+tools = {tool.name: tool for tool in toolkit.get_tools()}
+
+person = tools["mart_enrich_person"].invoke({
+    "url": "https://www.linkedin.com/in/dharmesh"
+})
+print(json.dumps(person, indent=2))
+```
+
+This adds `email=true` to Profile requests. Email lookup is off by default and applies only to person enrichment. The setting stays in application configuration, so an agent cannot turn it on through tool arguments.
+
+Work emails are best-effort. Read `workEmail`, `emailStatus`, `emailMatch` and `emailConfidence` together. `deliverable` describes the mailbox check; `emailMatch=inferred` does not independently prove the person owns the address. Unknown results keep the email null. Email lookup can take longer, and a returned profile still uses a credit when no email is found.
+
+## Prepare for a meeting
+
+```sh
+python examples/meeting_context.py https://www.linkedin.com/in/dharmesh > meeting-context.json
+```
+
+This combines a profile and up to three public posts. It preserves the profile if Posts fails and skips Posts when the profile is unavailable. Use the source bundle in your own brief renderer or AI workflow. It makes at most two requests and returns at most four billable records under the endpoint contract.
+
+Add `--email` to include work-email lookup. To try the complete output with fictional sample data and no API calls:
+
+```sh
+python examples/meeting_context.py --demo
+```
+
+## Tool behavior
+
+| Tool | Input | Result |
+| --- | --- | --- |
+| `mart_enrich_person` | Public person URL | Full profile response, with optional work-email lookup |
+| `mart_enrich_company` | Public company URL | Company response |
+| `mart_refresh_contact` | Public person URL | Refresh snapshot |
+| `mart_get_posts` | Person/company URL, bounded limit | Available public posts |
+
+Responses preserve the complete JSON returned by the selected endpoint. The short examples do not filter output fields. Complete illustrative responses are in `examples/responses/`; they are fictional demo fixtures, not coverage guarantees. Run `python examples/full_responses.py person https://www.linkedin.com/in/dharmesh` to print your own complete response.
+
+This prerelease wraps Profile, Company, Refresh and Posts, plus optional Profile email lookup. Jobs, People Search, Company Search, employer-domain overrides, employee expansion, comments and member expansion remain available through the direct API. Posts limits change the number of returned posts, not their fields.
+
+Responses preserve Mart's JSON fields. Check `accessible` and the endpoint availability fields before using the data. Refresh returns current fields; your application owns snapshot comparison, scheduling and CRM writes. Missing data must not be treated as a departure. Posts are a partial public feed.
+
+API keys stay in toolkit configuration, outside model-visible tool arguments, repr and serialized toolkit fields. Requests have a 30-second timeout by default. Redirects and automatic retries are disabled. HTTP errors, invalid JSON and network failures raise `ToolException` without exposing the request key. On rate limits, respect the returned delay before deciding whether to retry.
+
+The default post ceiling is three per call. You can configure one to ten. The tool's input schema reflects your ceiling, and omitting `limit` requests at most three posts within that ceiling. Apply a total call and credit budget in your agent because it may invoke tools repeatedly. Treat returned profile/post text as untrusted source data when giving it to a model.
+
+See [Mart's API reference](https://mart.dev/docs/) and [credits and limits](https://mart.dev/docs/#credits). Support: [support@mart.dev](mailto:support@mart.dev).
+
+## Local checks
+
+```sh
+pip install '.[test]'
+pytest tests --disable-socket --allow-unix-socket
+python -m build
+```
+
+Tests use mocked HTTP responses and do not spend Mart credits. Run them before making an authenticated smoke check. The release review records live-check results separately.
+
+## License
+
+The toolkit code uses the MIT license. This does not grant rights to LinkedIn data; your application is responsible for its use of returned information.

langchain_mart-0.1.0a2/examples/full_responses.py

@@ -0,0 +1,30 @@
+"""Print the full JSON response from one Mart tool without projecting fields."""
+
+import argparse
+import json
+
+from langchain_mart import MartToolkit
+
+
+def main():
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("action", choices=["person", "company", "refresh", "posts"])
+    parser.add_argument("url", help="Public LinkedIn URL for this action")
+    parser.add_argument("--limit", type=int, choices=range(1, 11), default=3,
+                        help="Maximum posts for the posts action (default: 3)")
+    parser.add_argument("--email", action="store_true", help="Search for a work email with the person action")
+    args = parser.parse_args()
+    if args.email and args.action != "person":
+        parser.error("--email is available only for the person action")
+    names = {"person": "mart_enrich_person", "company": "mart_enrich_company",
+             "refresh": "mart_refresh_contact", "posts": "mart_get_posts"}
+    tools = {tool.name: tool for tool in MartToolkit(max_posts=args.limit, include_email=args.email).get_tools()}
+    params = {"url": args.url}
+    if args.action == "posts":
+        params["limit"] = args.limit
+    result = tools[names[args.action]].invoke(params)
+    print(json.dumps(result, indent=2, ensure_ascii=False))
+
+
+if __name__ == "__main__":
+    main()

langchain_mart-0.1.0a2/examples/meeting_context.py

@@ -0,0 +1,47 @@
+"""Collect meeting source data. Keep the API key in MART_API_KEY."""
+
+import argparse
+from datetime import datetime, timezone
+import json
+from pathlib import Path
+
+from langchain_core.tools import ToolException
+from langchain_mart import MartToolkit
+
+
+def collect_context(url: str, toolkit: MartToolkit) -> dict:
+    """Return full source responses, retaining the profile when posts fail."""
+    tools = {tool.name: tool for tool in toolkit.get_tools()}
+    profile = tools["mart_enrich_person"].invoke({"url": url})
+    posts = {"posts": [], "status": "skipped_profile_unavailable"}
+    if profile.get("accessible") is True:
+        try:
+            posts = tools["mart_get_posts"].invoke({"url": url, "limit": min(3, toolkit.max_posts)})
+        except ToolException:
+            posts = {"posts": [], "status": "unavailable"}
+    return {"requestedUrl": url, "fetchedAt": datetime.now(timezone.utc).isoformat(),
+            "profileResponse": profile, "postsResponse": posts}
+
+
+def main():
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("url", nargs="?", help="Public LinkedIn profile URL")
+    parser.add_argument("--email", action="store_true", help="Also search for a work email")
+    parser.add_argument("--demo", action="store_true", help="Use fictional local fixtures, without a key or network calls")
+    args = parser.parse_args()
+    if args.demo:
+        if args.url or args.email:
+            parser.error("Use --demo alone; it does not perform a lookup")
+        fixtures = Path(__file__).with_name("responses")
+        profile = json.loads((fixtures / "profile.json").read_text())
+        result = {"demo": True, "requestedUrl": profile["url"], "profileResponse": profile,
+                  "postsResponse": json.loads((fixtures / "posts.json").read_text())}
+    else:
+        if not args.url:
+            parser.error("Provide a LinkedIn URL or use --demo")
+        result = collect_context(args.url, MartToolkit(max_posts=3, include_email=args.email))
+    print(json.dumps(result, indent=2, ensure_ascii=False))
+
+
+if __name__ == "__main__":
+    main()

langchain_mart-0.1.0a2/examples/responses/README.md

@@ -0,0 +1,7 @@
+# Complete response examples
+
+These are complete illustrative responses using fictional public-demo identities, not live recordings or field-coverage guarantees. Missing fields may be null or empty in real results. The tools preserve the full API response without projecting fields.
+
+`profile.json` shows profile-only mode. `profile-with-email.json` shows the response shape when `MartToolkit(include_email=True)` is used. Its fictional email and confidence value illustrate the contract; they are not a successful live lookup. The meeting example's `--demo` uses profile-only mode.
+
+Company, Refresh and Posts examples are in the matching JSON files. Employee expansion, comments and member expansion are not enabled by these examples.

langchain_mart-0.1.0a2/examples/responses/company.json

@@ -0,0 +1,123 @@
+{
+  "type": "linkedin-company",
+  "url": "https://www.linkedin.com/company/meridian-demo",
+  "accessible": true,
+  "company": {
+    "name": "Meridian",
+    "universalName": "meridian-demo",
+    "pageType": "company",
+    "publishedContacts": [
+      {
+        "type": "email",
+        "value": "hello@meridian.example",
+        "source": "company_about",
+        "sourceUrl": "https://www.linkedin.com/company/meridian-demo",
+        "evidence": "Contact hello@meridian.example for general enquiries."
+      }
+    ],
+    "employeeSearchCompanyIds": [
+      "90000001"
+    ],
+    "jobSearchUrl": "https://www.linkedin.com/jobs/search/?f_C=90000001",
+    "linkedInId": "90000001",
+    "tagline": "Design tools for a more connected world.",
+    "description": "Meridian builds collaborative design tools for product teams. Contact hello@meridian.example for general enquiries.",
+    "website": "https://meridian.example",
+    "domain": "meridian.example",
+    "industry": "Software Development",
+    "companySize": "51–200 employees",
+    "employeeCount": 128,
+    "employeeCountRange": {
+      "start": 51,
+      "end": 200
+    },
+    "headquarters": "San Francisco, California",
+    "locations": [
+      {
+        "formatted": "100 Example Avenue, San Francisco, CA 94105, US",
+        "street": "100 Example Avenue",
+        "cityLine": "San Francisco, CA 94105, US",
+        "countryCode": "US",
+        "addressLines": [
+          "100 Example Avenue",
+          "San Francisco, CA 94105",
+          "US"
+        ],
+        "directionsUrl": "https://www.google.com/maps/search/?api=1&query=San+Francisco",
+        "isPrimary": true
+      }
+    ],
+    "companyType": "Privately Held",
+    "founded": "2019",
+    "specialties": [
+      "Design tools",
+      "Collaboration",
+      "Design systems"
+    ],
+    "followers": 18420,
+    "address": {
+      "street": "100 Example Avenue",
+      "city": "San Francisco",
+      "region": "California",
+      "postalCode": "94105",
+      "country": "US"
+    },
+    "logo": "https://images.example.com/meridian-logo.png",
+    "banner": "https://images.example.com/meridian-banner.png",
+    "crunchbaseUrl": "https://www.crunchbase.com/organization/meridian-demo",
+    "similarCompanies": [
+      {
+        "name": "Northstar Studio",
+        "slug": "northstar-studio-demo",
+        "linkedinUrl": "https://www.linkedin.com/company/northstar-studio-demo",
+        "pageType": "company",
+        "industry": "Design Services",
+        "location": "Seattle, Washington",
+        "logo": "https://images.example.com/northstar-logo.png"
+      }
+    ],
+    "affiliatedPages": [
+      {
+        "name": "Meridian Labs",
+        "slug": "meridian-labs-demo",
+        "linkedinUrl": "https://www.linkedin.com/showcase/meridian-labs-demo",
+        "pageType": "showcase",
+        "industry": "Software Development",
+        "location": "San Francisco",
+        "logo": "https://images.example.com/meridian-labs.png"
+      }
+    ],
+    "employeeSample": [
+      {
+        "name": "Ava Morgan",
+        "profileUrl": "https://www.linkedin.com/in/ava-morgan-demo",
+        "source": "company_public_page"
+      }
+    ],
+    "featuredProducts": [
+      {
+        "name": "Meridian Canvas",
+        "linkedinUrl": "https://www.linkedin.com/products/meridian-canvas-demo",
+        "category": {
+          "name": "Collaboration Software",
+          "linkedinUrl": "https://www.linkedin.com/products/categories/collaboration-software"
+        },
+        "description": "A shared workspace for product design and review.",
+        "logoUrl": "https://images.example.com/meridian-canvas-logo.png",
+        "imageUrl": "https://images.example.com/meridian-canvas.png",
+        "source": "company_public_products"
+      }
+    ],
+    "linkedinUrl": "https://www.linkedin.com/company/meridian-demo",
+    "employees": [
+      {
+        "name": "Ava Morgan",
+        "headline": "Senior Product Designer at Meridian",
+        "location": "San Francisco, California",
+        "profileUrl": "https://www.linkedin.com/in/ava-morgan-demo"
+      }
+    ]
+  },
+  "tookMs": 1160,
+  "creditsUsed": 1
+}

langchain_mart-0.1.0a2/examples/responses/posts.json

@@ -0,0 +1,47 @@
+{
+  "type": "linkedin-posts",
+  "url": "https://www.linkedin.com/in/ava-morgan-demo",
+  "accessible": true,
+  "posts": [
+    {
+      "text": "A small update. A big step for our team. Introducing Meridian Canvas, a shared space for better design. #ProductDesign #Meridian",
+      "headline": null,
+      "url": "https://www.linkedin.com/feed/update/urn:li:activity:7500000000000000001",
+      "postType": "image",
+      "datePublished": "2026-09-16T10:00:00Z",
+      "likes": 128,
+      "comments": 12,
+      "reactionTypes": [
+        "LIKE",
+        "CELEBRATE",
+        "INSIGHTFUL"
+      ],
+      "author": {
+        "name": "Ava Morgan",
+        "url": "https://www.linkedin.com/in/ava-morgan-demo"
+      },
+      "image": "https://images.example.com/meridian-canvas-launch.png",
+      "images": [
+        "https://images.example.com/meridian-canvas-launch.png"
+      ],
+      "video": null,
+      "hashtags": [
+        "ProductDesign",
+        "Meridian"
+      ],
+      "activityId": "7500000000000000001",
+      "embeddedLinks": [
+        "https://meridian.example/canvas"
+      ],
+      "mentions": [
+        {
+          "name": "Meridian",
+          "type": "company",
+          "url": "https://www.linkedin.com/company/meridian-demo"
+        }
+      ]
+    }
+  ],
+  "tookMs": 1430,
+  "creditsUsed": 1
+}